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Introduction 


This book was written purely to making my working life easier! As 
a full time writer and Technical Editor of Acorn User I spend a 
considerable amount of time referring to tables, lists and data all 
concerning the BBC Micro. In short, this has always meant looking 
through perhaps two, three, four or more books or manuals to find 
the modicum of information I required. The purpose of this book is 
to bring all that information, and much more, under a single cover, 
while keeping it easy to use and straightforward to locate. 

This information is now available to you, the serious advanced 
programmer. I hope that you find it as invaluable as I do; certainly 
a copy never leaves my desk or the side of my two BBC Micros at 
any time! 

Bruce Smith 
New Southgate 
August 1985 



Part One 
BASIC 




1 BASIC Commands 


The following list details the syntax of all the commands present in 
BASIC. The following syntax is used in the list; 


<variable> 


<numeric> 

<'String> 


<constant> 

<proceed> 

<condition> 

/ 

{} 


A numeric variable such as NUMBER%. It may be 
integer or floating point. 

A number or the result of an expression. 

A string within quotes or a string variable such as Z$ 
or LONGS. 

An exact numeric value, not an evaluated one. 
Execute the following if true. 

Execute until evaluation of expression is true. 
Signifies that either syntax is acceptable. 

Items enclosed within may be repeated more than 
once or not at all. 


Command 


Syntax 


ABS 

<variable^ 

= ABS 

(<numeric>) 

ACS 

<variable> 

= ACS 

(<numeric>) 

ADVAL 

<variable'' 

= ADVAL (<numeric^) 

AND 

<variable> 

= <numeric> AND <numer; 

ASC 

<variable> 

= ASC ( 

' <string>) 

ASN 

<variable> 

= ASN 

(<numeric^) 

ATN 

<variable> 

= ATN 

(<numeric>) 

AUTO 

AUTO {<constant>}. 

{<constant>l 

BGET# 

<variable> 

= BGET# <variable> 

BPUT# 

BPUT# <variable>. 

<numeric> 

CALL 

CALL <numeric>, (<variable^!, |<st 
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Command 


Syntax 


CHAIN 

CHRS 

CLEAR 

CLOSE# 

CLG 

CLS 

COLOUR 

COS 

COUNT 

DATA 

DEF 

DEG 

DELETE 

DIM 

DIV 

DRAW 

ELSE 

END 

ENDPROC 

ENVELOPE 


EOF# 

EOR 

ERL 

ERR 

EVAL 

EXP 

EXT# 

FALSE 

FN 


CHAIN <string" 

- string - CHR$ (--'numeric ■) 

CLEAR 

CLOSE# <variable>/ CLOSE#0 

CLG 

CLS 

COLOUR -^numerio 
<variable> = COS (<numeric>) 

<variable> = COUNT 

DATA {<string>i, {<constant>( 

DEF FN/PROC 

■^variable"' = DEG <numeric> 

DELETE <-constant>, <constant> 

DIM <variable> / <string> (<numeric>(, 
<numeric>|) or DIM <variable><numeric> 
-<^variable> = <numeric> DIV -^numeric-- 
DRAW <numeric>, <numeric> 

IF. . .THEN. . .ELSE ■':statement> 

END 

ENDPROC 

ENVELOPE <variable>, <variable>, 
<variable>, <variable>. <variable>, 
-'variable>, <variable>, ^variable>, 
-^variable>, <variable>, <variable>, 
-^variable>, <variable>, <variable> 

-rvariable> = EOF# <variable> 

<variable> = <numeric> EOR <numeric> 
<variable> = ERL 
-'variable> = ERR 

i•^variable>| / |<string>i 
= EVAL (-^string'-) 

-^variable'- = EXP (<numeric>) 

<variable> = EXT# (<variable>) 

■'variable> = FALSE 

DEF FN {( <variable> / <string>{, <variable>/ 
<string>})} 
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Command 


Syntax 


FOR 

GCOL 

GET 

GETS 

GOSUB 

GOTO 

HIMEM 

IF 

INKEY 

INKEYS 

INPUT 

INPUT# 

INSTR 

I NT 

LEFTS 

LEN 

LET 

LIST 

LISTO 

LN 

LOAD 

LOCAL 

LOG 

LOMEM 

MIDS 

MOD 

MODE 

MOVE 

NEW 

NEXT 

NOT 


FOR <variable> = <numeric> TO <numeric> 
{STEP <numeric>) 

GCOL <'numeric>, <numeric> 

<'variable> = GETS 
<string> = GET 
GOSUB <numeric> 

GOTO <numeric> 

<variable> = HIMEM / HIMEM = <numeric> 
IF <condition> THEN <proceed> 

<variable> = INKEY (<numeric>) 

<string> = INKEYS (<numeric>) 

INPUT <variable> / INPUT <string'- 
INPUT# I <variable>, <variable> / <string> 

■^variable> = INSTR (<string>, <string>, 
{<numeric>() 

<variable> = INT <numeric> 

<string> = LEFTS (<string>, <nunieric>) 
<variable> = LEN (<string>) 

LET <variable> = <numeric> 

LIST {<constant>} {,} {<constant>} 

LISTO <constant> 

<variable> = LN <numeric> 

LOAD <string> 

LOCAL <string> / <variable> 

{, <string>/ <variable>} 

<variable> = LOG <numeric> 

LOMEM = <numeric> or <variable> = LOMEM 

•^string> = MIDS (<string>, <numeric> 

{, <numeric>}) 

-^variable> = <numeric> MOD <numeric> 
MODE <numeric> 

MOVE <numeric>, <numeric> 

NEW 

NEXT {<variable>l 
■^variable> = NOT <numeric> 


3 



Command 


Syntax 


OLD 

ON 

OPENUP 

OPENOUT 

OPT 

OR 

PAGE 

PI 

PLOT 

POINT 

POS 

PRINT 

PRINT# 

PROC 

PTR# 

RAD 

READ 

REM 

RENUMBER 

REPEAT 

REPORT 

RESTORE 

RETURN 

RIGHTS 

RND 

RUN 

SAVE 

SGN 

SIN 

SOUND 

SPC 

SQR 

STEP 


OLD 

ON <numeric> proceed 

<variable> = OPENUP (IN )*( <string>) 

<variable> = OPENOUT (<string>) 

OPT <numeric> 

<variable> = <numeric> OR <numeric> 

PAGE = <numeric> / <variable> = PAGE 
<variable> = PI 

PLOT <numeric>, <numeric>, <numeric> 
<variable> = POINT (<numeric>, <numeric>) 
<variable> = POS 

PRINT {<variable> / <string> / <nunieric>l 
PRINT# cvariable>, {<numeric> / <'string>i 
PROC {( <variable> / <string> / <numeric>f, 
<variable> /. <string> / <numeric>})} 
<variable> = PTR# <variable> 

/ PTR#^ <variable> = <numeric> 

<variable> = RAD <numeric> 

READ <variable> / <string> 

REM <anything> 

RENUMBER {<constant>{, <constant>}} 

REPEAT 

REPORT 

RESTORE {<numeric>} 

RETURN 

<string> = RIGHTS (<string>, «rnumeric>) 
<variable> = RND {(<numeric>)} 

RUN 

SAVE <string> 

<variable> = SGN (<numeric>) 

<variable> = SIN (<numeric>) 

SOUND <numeric>, <numeric>, <numeric>, 
•^numerio 

PRINT SPC (<numeric>) 

<variable> = SQR (<numeric^) 

FOR...TO...STEP <numeric> 
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Command 


Syntax 


STOP 

STR$ 

STRINGS 

TAB 

TAN 

THEN 

TIME 

TO 

TOP 

TRACE 

TRUE 

UNTIL 

USR 

VAL 

VDU 

VPOS 

WIDTH 


STOP 

<string> = STR$ (<numeric>) 

<string> = STRINGS (<numeric>, <string>) 
PRINT TAB ( <numeric> {, <numeric>|) 
<variable> = TAN <numeric> 

IF...THEN <proceed> 

TIME = <numeric> / <variable> = TIME 
FOR...<numeric> TO <numeric> 

<variable> = TOP 

TRACE ON / OFF / <numeric> 

<variable> = TRUE 
UNTIL <condition> 

<variable> = USR (<numeric>) 

<variable> = VAL (<string>) 

VDU <numeric> {, / ; <numeric>} {;} 
<variable> = VPOS 
WIDTH <numeric> 


* OPENUPisusedinBASIC2 
OPENIN is used in BASIC 1 
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2 Command 
Abbreviations 


Most of the keywords in BASIC may be abbreviated to a form 
consisting of one. two or three characters. The abbreviation is 
signalled by following the last letter in the abbreviation with a full 
stop. 


Command Minimum Abbreviation 


ABS 

ABS 

ACS 

ACS 

ADVAL 

AD. 

AND 

A. 

ASC 

ASC 

ASN 

ASN 

ATN 

ATN 

AUTO 

AU. 

BGET 

B. 

BPUT 

BP. 

CALL 

CA. 

CHAIN 

CH. 

CHRS 

CHR 

CLEAR 

CL. 

CLG 

CLG 

CLOSE 

CLO 

CLS 

CLS 

COLOUR 

C. 

COS 

COS 
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Command 


Minimum Abbreviation 


COUNT 

COU. 

DATA 

D. 

DEF 

DEF 

DEG 

DEG 

DELETE 

DEL. 

DIM 

DIM 

DIV 

DIV 

DRAW 

DR. 

ELSE 

EL. 

END 

END 

ENDPROC 

E. 

ENVELOPE 

ENV. 

EOR 

EOR 

EOF 

EOF 

ERL 

ERL 

ERR 

ERR 

ERROR 

ERR. 

EVAL 

EV. 

EXP 

EXP 

EXT 

EXT 

FALSE 

FA. 

FN 

FN 

FOR 

F. 

GCOL 

GO. 

GET 

GET 

GETS 

GE. 

GOSUB 

GOS. 

GOTO 

G. 

HIMEM 

H. 

IF 

'if 

INKEY 

INKEY 

INKEYS 

INK. 

INPUT 

I. 

INSTR( 

INS. 
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Command Minimum Abbreviation 


INT 

INT 

LEFTS( 

LE. 

LEN 

LEN 

LET 

(omit 

LINE 

LIN. 

LIST 

L. 

LN 

LN 

LOAD 

LO. 

LOCAL 

LOO. 

LOG 

LOG 

LOMEM 

LOM. 

MIDS( 

M. 

MOD 

MOD 

MODE 

MO. 

MOVE 

MOV. 

NEW 

NEW 

NEXT 

N. 

NOT 

NOT 

OFF 

OFF 

OLD 

0. 

ON 

ON 

OPENUP(IN) 

OP. 

OPENOUT 

OPENO 

OPT 

OPT 

OR 

OR 

PAGE 

PA. 

PI 

PI 

PLOT 

PL. 

POINT( 

PO. 

POS 

POS 

PRINT 

P. 

PROC 

PRO. 

PTR 

PT. 

RAD 

RAD 
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Command Minimum Abbreviation 


READ 

REA. 

REM 

REM 

RENUMBER 

REN. 

REPEAT 

REP. 

REPORT 

REPO 

RESTORE 

RES. 

RETURN 

R. 

RIGHTS( 

RI. 

RND 

RND 

RUN 

RUN 

SAVE 

SA. 

SGN 

SGN 

SIN 

SIN 

SOUND 

SO. 

SPC 

SPC 

SQR 

SQR 

STEP 

S. 

STOP 

STO . 

STRS 

STR. 

STRINGS( 

STRI 

TAB( 

TAB( 

TAN 

T. 

THEN 

TH. 

TIME 

TI. 

TO 

TO 

TRACE 

TR. 

TRUE 

TRUE 

UNTIL 

U. 

USR 

USR 

VAL 

VAL 

VDU 

V. 

VPOS 

VP. 

WIDTH 

W. 
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Command Tokens 


BASIC keywords are stored internally in memory in token form. 
This means that each keyword has an associated number in the 
range 0-255. Text following keywords is stored in true ASCII 
format. Note that many keywords also take into account any 
compulsory brackets that may follow them and these will not be 
present in the ASCII form, though the trailing close bracket will. In 
instances where an “=” may precede or follow the keyword, 
different tokens are used. Both tokens are listed. 


Command 


Token 


Hex Decimal 


ABS 

&94 

148 

ACS 

&95 

149 

ADVAL 

&96 

150 

AND 

&80 

128 

ASC 

&97 

151 

ASN 

&98 

152 

ATN 

&99 

153 

AUTO 

&C6 

198 

BGET 

&9A 

154 

BPUT 

&D5 

213 

CALL 

&D6 

214 

CHAIN 

&D7 

215 

CHR$ 

&BD 

189 

CLEAR 

&D8 

216 

CLG 

ScDA 

218 

CLOSE 

&D9 

217 

CLS 

&DB 

219 

COLOUR 

&FB 

251 

COS 

&9B 

155 

COUNT 

&9C 

156 

DATA 

&DC 

220 



Command 


Token 


DEF 

DEG 

DELETE 

DIM 

DIV 

DRAW 

ELSE 

END 

ENDPROC 

ENVELOPE 

EOR 

EOF 

ERL 

ERR 

ERROR 

EVAL 

EXP 

EXT 

FALSE 

FN 

FOR 

GCOL 

GET 

GETS 

GOSUB 

GOTO 

HIMEM 

IF 

INKEY 

INKEYS 

INPUT 

INSTR( 

INT 

LEFTS( 

LEN 

LET 

LINE 

LIST 

LN 

LOAD 

LOCAL 

LOG 

LOMEM 

MIDS( 

MOD 


Hex Decimal 


&DD 

&9D 

&C7 

&DE 

&81 

8cDF 

&8B 

&E0 

8cEl 

&E2 

&82 

&C5 

&:9E 

&:9F 

685 
&A0 
8cAl 
&A2 
&A3 
&A4 
&E3 
&E6 
&A5 
&BE 
&E4 
&:E5 

S:93/&D3 

&E7 

&A6 

&BF 

&E8 

Sck7 

&A8 

&C0 

&A9 

&E9 

686 
&C9 
ScAA 
&C8 
&EA 
ScAB 

&92AD2 

ScCl 

Sc83 


221 

157 

199 
222 

129 

223 
139 

224 

225 

226 

130 
197 

158 

159 

133 

160 
161 
162 

163 

164 

227 

230 

165 

190 

228 
229 

147/211 

231 

166 

191 

232 

167 

168 

192 

169 

233 

134 
201 

170 

200 

234 

171 

146/210 

193 

131 
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Command 

Token 

Hex 

Decimal 

MODE 

&EB 

172 

MOVE 

&EC 

173 

NEW 

&CA 

202 

NEXT 

&ED 

174 

NOT 

ScAC 

172 

OFF 

&87 

135 

OLD 

&CB 

203 

ON 

ScEE 

238 

OPENUP(IN) 

ScAD 

173 

OPENOUT 

8:AE 

174 

OR 

&84 

132 

PAGE 

&90/&D0 

144/208 

PI 

&AF 

175 

PLOT 

&F0 

240 

POINT( 

&B0 

176 

POS 

&B1 

177 

PRINT 

&F1 

241 

PROC 

&F2 

242 

PTR 

&8F/&CF 

143/207 

RAD 

&B2 

178 

READ 

&:F3 

243 

REM 

&F4 

244 

RENUMBER 

&CC 

204 

REPEAT 

&F5 

245 

REPORT 

&F6 

246 

RESTORE 

&F7 

247 

RETURN 

&F8 

248 

RIGHTS( 

&C2 

194 

RND 

&B3 

179 

RUN 

&F9 

249 

SAVE 

&CD 

205 

SGN 

&B4 

180 

SIN 

&B5 

181 

SOUND 

&D4 

212 

SPC 

&:89 

137 

SQR 

&B6 

182 

STEP 

&88 

136 

STOP 

&FA 

250 

STRS 

&C3 

195 

STRINGS( 

&C4 

196 

TAB( 

&8A 

138 

TAN 

&B7 

183 

THEN 

&:8C 

140 

TIME 

&91/&D1 

145/209 

TO 

&B8 

184 
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Command 


Token 


Hex Decimal 


TRACE 

&FC 

252 

TRUE 

&B9 

185 

UNTIL 

&FD 

253 

USR 

&:BA 

186 

VAL 

ScBB 

187 

VDU 

&EF 

239 

VPOS 

&BC 

188 

WIDTH 

&FE 

254 
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4 Error Messages 


The following alphabetical list of error messages contains the 
associated error code, as well as a brief description of what caused 
the error to occur. With the exception of the No room error all may 
be trapped with the ON ERROR statement. BASIC commands 
associated with error trapping are; 

ERL Returns the line number where the computer thinks the error 

occurred. It is used combined with the PRINT command, i.e. 
PRINT ERL. 

ERR Returns the number associated with the last error to occur. 

Again this can be used in combination with the PRINT 
statement. 

REPORT Prints out the last error message, except after power-on or 
BREAK when it prints the OS version. 


The error messages are detailed in alphabetical order below. 


grange 

8 

Accuracy lost 

23 

Arguments 

31 

Array 

14 

Bad call 

30 

Bad DIM 

10 

Bad hex 

28 


Denotes an illegal attempt to place 
a string in zero page RAM. 

Denotes that the result of a calcu¬ 
lation is insufficiently accurate. 

An incorrect number of arguments 
were passed to a PROC or FN. 

An unrecognized array has been 
located. 

Incorrect use of PROC or FN. 

Denotes use of incorrect DIM. 
syntax. 

Indicates an illegal hexadecimal 
character or missing &. 
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Bad MODE 

25 

Bad option 


Bad program 


Block? 

218 

Byte 

2 

Can't match FOR 

33 

Channel 

222 

Data? 

216 

DIM space 

11 

Division by zero 

18 

Eof 

223 

Escape 

17 

Exp range 

24 

Failed at xxx 


File? 

219 

FOR variable 

34 

Header? 

217 

Index 

3 


An attempt to change screen MODE 
inside PROC or FN has been made. 
This is not allowed. 

Illegal parameters were used as part 
of a *0PT command. 

The program in memory is suf¬ 
ficiently corrupted to make it unin¬ 
terpretable. It can usually be re¬ 
listed by correcting line length 
bytes. 

The last block of a cassette load was 
not found. 

The assembler encountered an im¬ 
mediate value greater than 255. 

Denotes the presence of a surplus 
FOR statement, or one that needs a 
corresponding NEXT statement. 

A filing system channel was ac¬ 
cessed without first being opened. 

A CFS error indicating that cor¬ 
rupted data has been received from 
the cassette presently being loaded. 

No memory available to dimension 
array. 

A division by zero was attempted. 
End of file reached. 

The Escape key has been pressed. 

The use of an exponential value 
greater than 88 was attempted. 

Indicates that the RENUMBER 
routine was unable to match a GOTO 
or GOSUB line value with an actual 
line number. 

An unexpected file name was en¬ 
countered by the CFS. 

The argument specified as the FOR 
variable is illegal. It must be a 
variable. 

Indicates that the header of the tape 
file is corrupted. 

An illegal index was used in the as¬ 
sembler. Indexes may only be Y or 
X. 
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LINE space 
Log range 
Missing. 

Missing" 

Missing) 

Mistake 

-ve root 
No GOSUB 

No FN 

No FOR 

No PROC 

No REPEAT 

No room 

No such FN/PROC 
No such line 
No such variable 

16 


There is not enough memory left to 
insert the line just entered. 

22 An attempt was made to find the 
logarithm of 0 or a negative value. 

5 A comma was expected, but was 
not found. 

9 A double quote was expected, but 
was not found. There should always 
be an even number of quotes in a 
line. 

27 A closed bracket was expected, but 
was not found. There should always 
be an even number of brackets in a 
line. 

4 The computer did not understand 
the command(s) entered directly at 
the keyboard or in a line. 

21 The square root of a negative num¬ 
ber was attempted. 

38 A RETURN was encountered in the 
program without a previous GOSUB 
being executed. These commands 
must be present in pairs. 

7 The end of a function was encount¬ 
ered without a prior FN call being 
executed. 

32 A NEXT statement was encountered 
with a corresponding FOR being 
active. 

13 An ENDPROC was encountered 
in the program without a prior 
PROC call being executed. 

43 An UNTIL was encountered in the 
program without a prior balancing 
REPEAT being encountered. 

0 The computer ran out of memory 
while running the program. Note 
that this error is untrappable. 

29 The specified function or procedure 
was not found. 

41 The line specified in a GOSUB or 
GOTO cannot be found. 

26 A variable was used within a 
PRINT or variable-assigning state¬ 
ment without first being assigned a 
value. 



No TO 

36 

Not LOCAL 

12 

ON range 

40 

ON syntax 

39 

Out of DATA 

42 

Out of range 

1 

Silly 


Syntax 

220 

String too long 

19 

Subscript 

15 

Syntax error 

16 

Too big 

20 

Too many FORs 

35 

Too many GOSUBs 

37 

Too many REPEATS 

44 

Type mismatch 

6 


The TO statement has been left out 
of a FOR XXX TO xxx structure. 

The statement LOCAL may only be 
used within an FN or PROC call. 

The control variable was less than 1 
or greater than the total number of 
line numbers listed and therefore 
the GOTO or GOSUB could not be 
calculated. 

The statement ON must be followed 
by a number or variable. 

Not enough data statements are 
present to satisfy the number of 
READS specified in the program. 

A branch greater than that allowed 
was attempted by the assembler. 

A step size of 0 or greater tham 255 
was specified in an AUTO or 
RENUMBER command. 

Issued by the CFS to indicate an 
error in syntax. 

The string definition exceeded the 
maximum number of characters 
possible, i.e. 255. 

The specified subscript was outside 
that DIMed for the array or was a 
negative quantity. 

The command contained an error 
of syntax. 

A value was too large for the com¬ 
puter to manipulate. 

Too many FOR. . .NEXT loops 
were operative at that moment. 
Only ten such loops may be nested 
at any one time. 

Indicates that too many GOSUBs 
were in operation at that moment. 
Only 26 may be operative at any 
one time. 

Too many REPEAT...UNTIL 
loops were operative at that 
moment. The maximum value that 
may be nested is 20. 

Indicates that a string was expected 
but a number was present, and vice- 
versa. 
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5 BASIC Structures 


Eight programming structures are implemented on the BBC 
Micro. In alphabetical order these are: 

FOR...NEXT...(STEP) 

FUNCTIONS 
GOSUB...RETURN 
IF...THEN...(ELSE) 

ON...GOSUB 
ON...GOTO 
PROCEDURES 
REPEAT...UNTIL 

Some of these structures may be nested inside one another. The 
maximum number of nests for those are: 


FOR...NEXT...(STEP) 
GOSUB...RETURN 
REPEAT...UNTIL 


Maximum of 10 loops at one time 
Maximum of 26 at any one time. 
Maximum of 20 at any one time. 
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6 Key Codes 


This section summarizes the ASCII and INKEY code values of each 
key. The INKEY code values are of particular importance when 
testing for a specific key at any instant from within a program. 


Key Codes 


Key/ 

character 

ASCII 

dec. 

hex. 

INKEY 
dec. hex. 

SPACE 

32 

20 

- 99 

9D 

1 

33 

21 



‘ 

34 

22 



# 

35 

23 



$ 

36 

24 



% 

37 

25 



& 

38 

26 




39 

27 



( 

40 

28 



) 

41 

29 



* 

42 

2A 



+ 

43 

2B 




44 

2C 

-103 

99 

_ 

45 

2D 

- 24 

E8 


46 

2E 

-104 

98 

/ 

47 

2F 

-105 

87 

0 

48 

30 

- 40 

D8 

1 

49 

31 

- 49 

CF 

2 

50 

32 

- 50 

CE 

3 

51 

33 

- 18 

EE 

4 

52 

34 

- 19 

ED 

5 

53 

35 

- 20 

EC 

6 

54 

36 

- 53 

CB 

7 

55 

37 

- 37 

DB 

8 

56 

38 

- 22 

EA 

9 

57 

39 

- 39 

D9 


58 

3A 

- 73 

B7 


59 

3B 

- 88 

A8 

< 

60 

3C 



= 

61 

3D 



> 

62 

3E 



9 

63 

3F 



@ 

64 

40 

- 72 

B8 
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Key/ 

character 

ASCII 

dec. 

hex. 

INKEY 
dec. hex. 

A 

65 

41 

- 66 

BE 

B 

66 

42 

-101 

9B 

C 

67 

43 

- 83 

AD 

D 

68 

44 

- 51 

CD 

E 

69 

45 

- 35 

DD 

F 

70 

46 

- 68 

BC 

G 

71 

47 

- 84 

AC 

H 

72 

48 

- 85 

AB 

I 

73 

49 

- 38 

DA 

J 

74 

4A 

- 70 

BA 

K 

75 

4B 

- 71 

B9 

L 

76 

4C 

- 87 

A9 

M 

77 

4D 

-102 

9A 

N 

78 

4E 

- 86 

AA 

O 

79 

4F 

- 55 

C9 

P 

80 

50 

- 56 

C8 

Q 

81 

51 

- 17 

EF 

R 

82 

52 

- 52 

CC 

S 

83 

53 

- 82 

AE 

T 

84 

54 

- 36 

DC 

U 

85 

55 

- 54 

CA 

V 

86 

56 

-100 

9C 

W 

87 

57 

- 34 

DE 

X 

88 

58 

- 67 

BD 

Y 

89 

59 

- 69 

BB 

Z 

90 

5A 

- 98 

9E 

[ 

91 

5B 

- 57 

C7 

\ 

92 

5C 

-121 

87 

1 

93 

5D 

- 89 

A7 

A 

94 

5E 

- 25 

E7 


95 

5F 

- 41 

D7 

# 

96 

60 



a 

97 

61 



b 

98 

62 



c 

99 

63 



d 

100 

64 



e 

101 

65 



f 

102 

66 



O 

103 

67 



h 

104 

68 



i 

105 

69 



j 

106 

6A 



k 

107 

6B 



1 

108 

6C 



m 

109 

6D 



n 

110 

6E 



0 

111 

6F 



P 

112 

70 



q 

113 

71 



r 

114 

72 



s 

115 

73 



t 

116 

74 



u 

117 

75 



V 

118 

76 



w 

119 

77 



X 

120 

78 



y 

121 

79 



2 

122 

7A 
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Key/ 

character 

ASCII 

dec. 

hex. 

INKEY 
dec. hex. 

< 

123 

7B 


1 

124 

7C 


> 

125 

7D 



126 

7E 


DELETE 

127 

7F 
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7 Graphics 


There are five screen modes on which graphics may be displayed. 
The details of these are as follows: 


Mode 

Resolution 

Colours 

Memory 

0 

640 

* 256 

2 

20K 

1 

320 

* 256 

4 

20K 

2 

160 

* 256 

16 

20K 

4 

320 

* 256 

2 

10K 

5 

160 

* 256 

4 

10K 


Despite changes in screen resolution the MOS software allows all 
screen modes to be treated as a 1279 * 1023 grid, with Origin 
situated at 0 , 0. 



-Y 

Figure 7.1 Graphics co-ordinate system. 



Area displayed 
on screen 
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Points may be plotted off the screen by specifying negative draw 
or plot arguments. Screen and off-screen plotting arguments are 
given in Figure 7.1. 

The graphics origin may be moved using: 

VDU29, X; Y; 

To move the origin to centre-screen use; 

VDU29, 640; 512; 


PLOT SUMMARY 


Plot number/ 
offset 

Effect 

0 

Move relative to last point. 

1 

Draw in current foreground colour relative to last 
point. 

2 

Draw in logical inverse colour relative to last point. 

3 

Draw in background colour relative to last point. 

4 

Move to absolute point. 

5 

Draw in current foreground colour to absolute point. 

6 

Draw in logical inverse colour to absolute point. 

7 

Draw in background colour to absolute point. 

8-15 

As 0-7 but last point in line omitted when an 
‘inverting’ plot code is used. 

16-23 

Plots performed using a dotted line. 

24-31 

Plots performed using a dotted line but omitting last 
point. 

32-63 

Reserved for use by graphics extensions ROMs. 

64-71 

Plot single points only. 

72-79 

Fill horizontal line in a left and then right direction. 

80-87 

Plot and fill triangle using last two sets of positions 
plotted. 

88-95 

Clear line (i.e. un-draw) in right direction only. 

96-255 

Not used. 
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GRAPHICS PIXELS 


Depending on the mode selected the pixel size will vary. These are 
detailed below and illustrated in Figure 7.2. 


Mode 0 
1 pixel = 2x4 


Modes 1 and 4 
Pixel size = 4x4 


Modes 2 and 5 


Pixel size = 8x4 


Figure 7.2 Screen pixel configurations. 
Mode 0 Pixel size = 2*4 
Mode 1 : Pixel size = 4*4 
Mode 2 : Pixel size = 8*4 
Mode 4 : Pixel size = 4*4 
Mode 5 : Pixel size = 8*4 


SCREEN MAPS 

Each screen mernory map is summarized below: 


Mode 

Start address 

End address 

0 

(128) 

&3000 

&7FFF 

1 

(129) 

&3000 

&7FFF 

2 

(130) 

&3000 

&7FFF 

3 

(131) 

&4000 

&7FFF 

4 

(132) 

&5800 

&7FFF 

5 

(133) 

&5800 

&7FFF 

6 

(134) 

&6000 

&7FFF 

7 

(135) 

&7C00 

&7FFF 
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Mode numbers in brackets refer to equivalent shadow modes on the 
BBC B + when shadow memory is activated. Note that, with the 
exception of mode 7 memory, bytes do not run consecutively across 
the screen, but in blocks of eight bytes running down the screen. 
Figure 7.3 illustrates this diagrammatically for the first 24 bytes in 
any screen mode. 


HIMEM+0 

HIMEM+8 

HIMEM + 16 


HIMEM + 1 

HIMEM+9 

HIMEM + 17 


HIMEM+2 

HIMEM + 10 

HIMEM + 18 


HIMEM+3 

HIMEM+11 

HIMEM + 19 


HIMEM+4 

HIMEM + 12 

HIMEM+20 


HIMEM+5 

HIMEM + 13 

HIMEM+21 


HIMEM+6 

HIMEM + 14 

HIMEM+22 


HIMEM+7 

HIMEM + 15 

HIMEM+23 











HIMEM + X0 

HIMEM + X8 

HIMEM + X16 


HIMEM + Xl 

HIMEM + X9 

HIMEM + X17 


HIMEM + X2 

HIMEM + X10 

HIMEM + X18 


HIMEM + X3 

HIMEM + xil 

HIMEM + X19 


HIMEM + X4 

HIMEM + X12 

HIMEM + X20 


HIMEM + X5 

HIMEM + X13 

HIMEM + X21 


HIMEM + X6 

HIMEM + X14 

HIMEM + X22 


HIMEM + X7 

HIMEM + X15 

HIMEM + X23 



Screen layout: down eight bytes - along one byte - up eight 
and repeat 

Figure 7.3 Screen layout. 
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BYTE CONSTRUCTION 

Figure 7.4 shows the horizontal pixel configuration for each 
graphics mode at byte level and Figure 7.5 is a graphics planner for 
modes 0,1,2,4 and 5. 

Modes 0 and 4 

1 bit per pixel 
= 8 pixels per byte 

Modes 1 and 5 

2 bits per pixel 
= 4 pixels per byte 


Mode 2 
4 bits per pixel 
= 2 pixels per byte 


1024 

1000 


900 


800 


700 


600 


500 


400 


300 


200 


100 


0 

0 100' 200 300 400 500 600 700 800 900 1000 1100 1200 1280 

Figure 7.5 Graphics planner for modes jF, 1, 2, 4 and 5. 


Figure 7.4 Pixel configurations. 
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8 Colours 


A total of 16 colours are available for use on the BBC Micro. The 
physical values associated in the palette with each are listed below. 
A background colour is distinguished from its foreground colour 
by having its most significant bit set, i.e. bit 7. Therefore a 
background colour = foreground colour + 128. See VDU 19 
(Section 15) for details on changing the palette. 


Colour code 

Colour 

Foreground Background 



0 

128 

Black 

1 

129 

Red 

2 

130 

Green 

3 

131 

Yellow 

4 

132 

Blue 

5 

133 

Magenta 

6 

134 

Cyan 

7 

135 

White 

8 

136 

Black-white flashing 

9 

137 

Red-cyan flashing 

10 

138 

Green-magenta flashing 

11 

139 

Yellow-blue flashing 

12 

140 

Blue-yellow flashing 

13 

141 

Magenta-green flashing 

14 

142 

Cyan-red flashing 

15 

148 

White-black flashing 
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9 Colour Modes 


Three separate colour modes are available for use—namely two- 
colour. four-colour and sixteen-colour. This reflects the maximum 
number of colours available in a particular screen mode. The 
following list details the logical colour and its physical value 
assigned to each screen mode. For details on changing the palette 
see Section 15. 


Two-colour modes: Screen modes 0 and 4 
(modes 128 and 132) 


Logical 

Physical 

Colour 

0 

0 

Black 

1 

7 

White 

Four-colour modes: Screen modes 1 and 5 
(modes 129 and 133) 

Logical 

Physical 

Colour 

0 

0 

Black 

1 

1 

Red 

2 

3 

Yellow 

3 

7 

White 
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Sixteen-colour mode: Screen mode 2 (mode 130) 


Logical 

Physical 

Colour 

0 

0 

Black 

1 

1 

Red 

2 

2 

Green 

3 

3 

Yellow 

4 

4 

Blue 

5 

5 

Magenta 

6 

6 

Cyan 

7 

7 

White 

8 

8 

Black-white flashing 

9 

9 

Red-cyan flashing 

10 

10 

Green-magenta flashing 

11 

11 

Yellow-blue flashing 

12 

12 

Blue-yellow flashing 

13 

13 

Magenta-green flashing 

14 

14 

Cyan-red flashing 

15 

15 

White-black flashing 


Modes in brackets refer to shadow modes on the BBC B + . 
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10 GCOL Parameters 


GCOL0,C% 
GCOL1,C% 
GCOL 2, C% 
GCOL 3, C% 
GCOL 4,C% 


Plot the colour C% onto the screen ignoring the presence 
of any other colour there. 

Logically OR the colour C% with the logical colour at the 
PLOT position and then PLOT the resultant colour. 

Logically AND the colour C% with the logical colour at 
the PLOT position and then PLOT the resultant colour. 

Logically EOR the colour C% with the logical colour at 
the PLOT position and then PLOT the resultant colour. 

Invert (logical NOT) the colour present at the PLOT 
position ignoring the colour C%. 
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11 Windows 


Windows allow you to contain your text or graphics within a defined 
boundary on the screen. Graphics and text windows may be 
implemented using VDU 24 and VDU 28 statements as follows: 

GRAPHICS WINDOWS 

Graphics windows may be specified with the VDU 24 statement 
which takes the form: 

VDU 24, a; b; c; d; 

where a, b, c and d refer to the absolute co-ordinates of the 
window. (Figure 11.1). 



Figure 11.1 Graphics window 
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TEXT WINDOWS 

Text windows may be specified with the VDU 28 statement which 
takes the form: 

VDU 28, a, b, c, d 

where a, b, c and d refer to the text co-ordinates as used with 
TAB measured from the top left hand comer. (Figure 11.2). 


0 

c 

19/39/79 

a 

- ► 


d 

1 

1 




V 




==;WINb6w=r:= 



24/31 





Figure 11.2 Text window 
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12 Text Planners 


The following pages contain text layout sheets for all eight screen 
modes on the BBC Microcomputer. The characters per line and 
lines per mode vary as follows: 

Mode 01234567 

Characters 80 40 20 80 40 20 40 40 

Lines 32 32 32 25 32 32 25 25 

The screen modes available will depend on the amount of memory 
present as follows: 


Model A Modes 
Model B Modes 
Model B + Modes 
Modes 


4,5,6 and 7 

0,1, 2, 3, 4, 5, 6 and 7 

0, 1, 2, 3, 4, 5, 6 and7 

128, 129, 130, 131, 132, 133. 134 and 135 


In the case of the B+ all screen modes are available at any time, 
even with long programs, by switching in the shadow screen 
memory. They are depicted by modes 128 to 135 inclusive. 
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Figure 12.1 Text planner for modejT'. 
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Figure 12.2 Text planner for mode 3. 



Figure 12.3 Text planner for modes 1 and 4. 
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0 


10 


20 


30 
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Figure 12.5 Text planner for modes 6 and 7. 
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13 Teletesct 


Mode 7 is the Teletext mode and comprises 25 lines (0 to 24) of 40 
characters (0 to 39). Section 12 contains the mode 7 text planner. 

DISPLAY CONTROL CHARACTERS 

These control codes may be embedded within text using the PRINT 
CHR$ (X) command, where x is the control code. The codes are as 
follows: 


CHR$ 

Control character 

129 

Alpha red 

130 

Alpha green 

131 

Alpha yellow 

132 

Alpha blue 

133 

Alpha magenta 

134 

Alpha cyan 

135 

Alpha white 

136 

Flash 

137 

Steady 

140 

Normal height 

141 

Double height 

145 

Graphic red 

146 

Graphic green 

147 

Graphic yellow 

148 

Graphic blue 

149 

Graphic magenta 

150 

Graphic cyan 
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CHR$ 

Control character 

151 

Graphic white 

152 

Conceal display 

153 

Continuous graphics 

154 

Separated graphics 

156 

Black background 

157 

New background 


The function keys can be programmed to produce some of these 
control codes. (See Section 30.) 


GRAPHICS CODES 

The Teletext character set is detailed in the following pages and 
may be selected by printing the appropriate control code before 
printing the character with CHR$. 

Each Teletext graphics cell consists of a 2 *3 pixel matrix. Each 
pixel has its own weight value which may be used to calculate the 
code of the graphics character. Each set pixel should have its 
weight summed and 160 (128 32) should be added to the total 

weight to give the correct code. 

Pixel weights are: 


1 

2 

4 

8 

16 

64 


The print code for'H would therefore be 1 + 2 + 16 = 19 + 160 = 179. 
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Figure 13.1 (a) Teletext alphanumeric set 
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Figure 13.1(b) Teletext alphanumeric set. 
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250 251 252 253 254 255 

B B D H H □ 


Figure 13.1(c) Teletext alphanumeric set. 
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192 

193 

194 

1 ^ 

196 



D 





197 

198 

199 

200 

201 






D 


202 

203 

204 

205 

206 


D 


D 




207 

208 

209 

210 

211 



D 





212 

213 

214 

215 

216 








217 

218 

219 

220 

221 








222 

223 

224 

225 

226 


HH 






Figure 13.1(d) Teletext alphanumeric set. 



32 33 

34 

35 36 

37 

38 

39 

■ 1 

B 

ES E 

a 

B 

a 

40 41 

42 

43 44 

45 

46 

47 

E H 

E 

m 

a 

s 

a 

48 49 

50 

51 52 

53 

54 

55 

1 a 

5 

a 9 

1 

S 

a 

56 57 

58 

59 60 

61 

62 

63 

n a 

S 

a m 

a 

H 

a 


Figure 13.2(a) Teletext graphic character set. 
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Figure 13.2(b) Teletext graphic character set. 

95 96 97 98 99 100 101 102 

103 104 105 106 107 108 109 110 

HBEBBEaE 

111 112 113 114 115 116 117 118 

119 120 121 122 123 124 125 126 

160 161 162 163 164 1 ^ 166 167 

■aBHaaaa 

Figure 13.2(c) Teletext graphic character set. 
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168 169 170 171 172 173 174 175 


176 177 178 179 180 181 182 183 

lassaasa 


184 185 186 187 188 189 190 191 

BBSsaaHffl 


224 225 226 227 228 229 230 231 


232 233 234 235 236 237 238 

E H B B E ffl Eg 


239 



240 241 242 243 244 245 246 247 

HaHfflfflfflffla 


248 249 250 

B ffl B 


251 252 253 254 

ffl a B 


255 


Figure 13.2(d) Teletext graphic character set. 
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14 Sound and Envelope 


SOUND 

The SOUND command takes four parameters and is of the form: 
SOUND C, A, P, D 

where: 


C is the Channel number 
A is the Amplitude 
P is the Pitch 
D is the Duration 


Channel 

The BBC Micro has four voices numbered 0.1.2 and 3. Channels 
1. 2 and 3 are the pure note channels while channel 0 is the noise 
channel. 


Amplitude 

The amplitude defines the loudness of the note. This varies between 
0 and —15. where —15 is the loudest amplitude decreasing to an 
amplitude of 0 which is. in effect, off. 
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Pitch 


Note pitches are selected in quarter semi-tone intervals. Figure 
14.1 gives typical pitch values for notes. 


A 

Bt 

B 

C 

C# 

D 


E 

F 

F4 

G 

G# 


0 

1 

5 

9 

13 

17 

21 

25 

29 

33 

37 

41 

45 

49 

53 

57 

61 

65 

69 

73 

77 

81 

85 

89 

93 

97 

101 

105 

109 

113 

117 

121 

125 

129 

133 

137 

141 

145 

149 

153 

157 

161 

165 

169 

173 

177 

181 

185 

189 

193 

197 

201 

205 

209 

213 

217 

221 

225 

229 

233 

237 

241 

245 

249 

253 








Figure 14.1 Pitch values in semi-tone intervals. 


Duration 

This sets the duration of the note and is measured in twentieths of a 
second. 


Sound effects 

As well as specifying the channel the first value of the SOUND 
command may be used to control the way in which the command 
operates. This change in parameter is normally signified by 
specifying a hexadecimal number which may be up to four 
characters long, and takes the form: 

SOUND &JSFC 
where: 

J is the continuation control 
S is the note synchronization control 
F is the flush control 
C is the channel number as detailed above. 
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Continuation control 

Takes the value 0 or 1. If J= 1 then the note being played is allowed 
to continue regardless of the rest of the SOUND statement. 


Sync, control 

Allows the synchronization of a number of notes so that they may 
be played together. If S=0 each note is played in turn. 


Flush control 

Allows the sound queue to be flushed if F = 1 so that the next sound 
can be played immediately. 


ENVELOPE 

The ENVELOPE statement uses 14 parameters which define its 
action. It is of the form: 

ENVELOPE en, s, pi, p2, p3, psl, ps2, ps3, aa, ad, as, 
ar, ala, aid 

Here is a short explanation of each parameter: 


en Envelope number which may be 1. 2. 3 or 4. If BPUT # is not 
being used envelopes may be numbered 1 to 16. 

s Bits 0-6 specify the length of each step in hundredths of 

seconds which may therefore be 0 to 127. X000000 to xl 111111. 
The envelope will repeat if bit 7 = 0. otherwise end. 

pi Specifies the pitch step in Section 1 of the envelope, and is in 

the range 127 to -128. 

p2 Specifies the pitch step in Section 2 of the envelope, and is in 

the range 127 to -128. 

p3 Specifies the pitch step in Section 3 of the envelope, and is in 

the range 127 to -128. 
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psl Number of pitch steps in Section 1 of the envelope, in the range 
0to 255. 

ps2 Number of pitch steps in Section 2 of the envelope, in the range 
0to 255. 

ps3 Number of pitch steps in Section 3 of the envelope, in the range 
0 to 255. 

aa Attack phase amplitude change per step, in the range 127 to 

-127. 

ad Decay phase amplitude change per step, in the range 127 to 
-127. 

as Sustain phase amplitude change per step, in the range 0 to -127. 

ar Release phase amplitude change per step, in the range 0 to 

-127. 

ala Attack phase end target level, in the range 0 to 126. 

aid Decay phase end target level, in the range 0 to 126. 


Pitch envelope 

The following figure shows a typical pitch envelope: 
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Amplitude envelope 

The following figure shows a typical amplitude envelope: 
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15 VDU Commands 


The VDU commands allow many BASIC commands to be strung 
together into a line by condensing them into a single VDU 
statement. At machine level all VDU commands may be performed 
using 0S7/RCH. 

VDU 0 Does nothing. 

VDU 1 Send next character to printer only. Printer must first be 

enabled with VDU 2. 

VDU 2 Enable printer. 

VDU 3 Disable printer. 

VDU 4 Write text at text cursor position. 

VDU 5 Write text at graphics cursor position. 

VDU 6 Enable screen display. 

VDU 7 Emit bleep on internal speaker. 

VDU 8 Move cursor left one position. 

VDU 9 Move cursor forward (right) one position. 

VDU 10 Move cursor down one line. 

VDU 11 Move cursor up one position. 

VDU 12 Clear screen to text background colour. 

VDU 13 Move cursor to start of current line. 

VDU 14 Enable paged mode. 

VDU 15 Disable paged mode. 

VDU 16 Clear graphics area of screen to graphics background 

colour. 

VDU 17 Change text and foreground colours, i.e. perform as 
COLOUR. Statement followed by one parameter defining 
the new colour. For example: 

VDU 17, 1. 
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VDU 18 Define foreground and background colours, i.e. perform 

GCOL c, n. Statement followed by two parameters 
defining operation and colour. For example; 

VDU 18, 1, 2. 

VDU 19 Define physical colour for each logical colour. Statement 

followed by six parameters the first of which defines 
logical colour and the second the physical colour to be 
placed in that palette position. For example; 

VDU 19, 1, 4, 0, 0, 0. 

The final three zeros are padding characters. The 
statement could also be written as; 

VDU 19 , 1, 4; 0 ; 

VDU 20 Restore default text and graphics foreground colours. 

VDU 21 Disable screen display. 

VDU 22 Select screen mode. This is similar in operation to the 

MODE statement, except that the value of HIMEM is 
unaltered. It is followed by a single parameter which 
specifies the mode. For example; 

VDU 22 , 6 select screen mode 6. 

VDU 23 Allows user-defined characters and the 6845 CRTC 
registers to be programmed. 

Character definitions are followed by nine parameter 
bytes; the first is the ASCII character to be defined and 
the rest, the eight-byte bit pattern of the character. For 
example; 

VDU 23, 128, 255, 129, 129, 129, 129, 129, 

129, 255 

will give the ASCII code 128 a box shape. This shape may 
be printed using VDU 128 or PRINT CHR$ (128). 

To program the 6845 CRTC the first parameter byte 
should be zero and the second and third the byte X. to be 
written to register R. For example; 

VDU 23, 0, R, X, 0, 0. 0, 0, 0, 0. 

VDU 24 Define graphics window.(See Section 11.) 

VDU 25 Plot point as specified. This action is identical to PLOT. It 

is of the form VDU 25, a, x; y; where a is the plot code 
and X and y the co-ordinates. 

VDU 26 Restore graphics and text windows to their default 

values. 

VDU 27 Does nothing. 

VDU 28 Define text window.(See Section 11.) 
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VDU 29 

VDU 30 
VDU 31 

VDU 127 


Move graphics origin to position x, y. The statement 
takes the form VDU 29, x; y; where x and y are the 
graphics co-ordinates. 

Move text cursor to top right corner of screen. 

Move text cursor to screen co-ordinates specified. The 
command takes the form VDU 31, x, y where x and y are 
text co-ordinates. This command performs as PRINT 
TAB(X,Y). 

Move cursor back one position and delete. 
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16 Operator Precedence 


There are 22 mathematical and logical operators implemented 
on the BBC Micro. These are arranged into seven groups in 
descending order of precedence. Operators in Group 1 have a 
higher order of importance than operators in Group 2 and must 
therefore be evaluated first; Group 2 operators have precedence 
over Group 3 and so forth. It is important to take this order of 
precedence into account when programming mathematical and/or 
logical functions, otherwise the desired result will not be 
forthcoming. For example. 3*3+3 = 12 but 3*(3+3) will give 18. 


Group 1 

Unary minus 

Group 4 

+ 


Unary plus 


— 


NOT 




Functions 

Group 5 

= 


Brackets 


<> 


! (word indirection) 


< 


? (byte indirection) 


> 




< = 

Group 2 

“ (raise to power of) 


> = 

Group 3 

* 

Group 6 

AND 


/ 




DIV 

Group 7 

OR 


MOD 


EOR 
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17 LISTO, Print 
Formatting and 
Logical Operators 

LISTO 

The LISTO command can be used to choose the format of a 
program listing. In general it adds padding spaces to make a 
program more readable and show clearly its structures. 

LISTO options are: 

LISTO 0 List with no extra spaces. 

LISTO 1 List with space between program line numbers and 

program text. 

LISTO 2 List with spaces to indent FOR. . . NEXT loops. 

LISTO 3 Combined effect of LISTO 1 and LISTO 2. 

LISTO 4 List with spaces to indent all REPEAT. . . UNTIL loops. 

LISTO 5 Combined effect of LISTO 1 and LISTO 4. 

LISTO 6 Combined effect of LISTO 2 and LISTO 4. 

LISTO 7 Combined effect of LISTO 1, LISTO 2 and LISTO 4. 

PRINT FORMATTING 

The BASIC integer variable @ % controls formatting. Print 
formatting is defined in four-byte values, and takes the form: 

@% = Scwwxxyyzz 
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where: 

ww = STR$ format control if ww = 1 

XX = format value, for example giving a fixed number of decimal 
places 

yy = number of decimal places 
zz = print field width 

Thus: 

@% = &20509 

gives a format value of 2,5 decimal places, and a field print width of 
9. 

The default value of @ % is &90 A. 

Examples: 


@ % value 

Value of NUM 

PRINT NUM 

@.% = 

&20209 

NUM = 

100.2 

100.20 

II 

&20509 

NUM = 

100.2 

100.20000 

@% = 

&20109 

NUM = 

100.1234 

100.1 

@% = 

&:10209 

NUM = 

100.123 

1.0E2 


LOGICAL OPERATORS 

The three logical operators are AND, OR and EOR. The operation of 
each of these at bit level is detailed below: 


AND 

The four rules of AND are: 


1. 0AND0 = 0 

2. 0 AND 1 = 0 

3. 1AND0 = 0 

4. 1 AND 1 = 1 
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A 1 results only if both bits under test are 1. Any other combination 
gives a result of 0. 


OR 

The four rules of OR are: 


1. 0OR0 = 0 

2. 0OR1 = 1 

3. 1OR0 = 1 

4. 1 OR 1 = 1 


A 1 results if a 1 is present in any of the bits under test. A result of 0 
is only possible if both bits are 0. 


EOR 

The four rules of EOR are: 


1. 0EOR0 = 0 

2. 0EOR1 = 1 

3. 1EOR0=1 

4. 1 EOR 1 = 0 


A 1 results only if both bits under test are unlike. A result of 0 
indicates that both bits are equal. 
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18 User-definable 
Characters 


The ASCII character codes 128 to 159 may be programmed by the 
user to hold shapes. Note that these user-defined shapes are not 
available in mode 7. Each character is made up of a matrix one byte 
wide by eight bytes deep. Characters are defined using the VDU 23 
statement followed by the ASCII character code and eight bytes 
representing the bit pattern of the eight bytes forming the 
character. 

If the character font is not exploded then a wrap around will 
occur with these character numbers. For example, characters 224 
to 255 will mirror them. 

CHARACTER DEFINITION PLANNER 



Figure 18.1 User-definable character chart. Define characters with: 
VDU23, char, a, b, c, d, e,f g, h where char = ASCII character code and a 
to h are the decimal values of each line’s binary bit pattern. 
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CHARACTER STORAGE 

The user-definable character buffer occupies page &C (&C00 to 
&CFF) . The following addresses, in steps of eight, are associated 
with each of the normal user-defined character codes: 


ASCII code 

Start address 

128 

&C00 

129 

&C08 

130 

&C10 

131 

S:C18 

132 

&C20 

133 

&C28 

134 

&C30 

135 

S:C38 

136 

&C40 

137 

&C48 

138 

&C50 

139 

&C58 

140 

&C60 

141 

&C68 

142 

&C70 

143 

&C78 

144 

&C80 

145 

&C88 

146 

&C90 

147 

&C98 

148 

&CA0 

149 

&CA8 

150 

&CB0 

151 

&CB8 

152 

&CC0 

153 

&CC8 

154 

&:CD0 

155 

&CD8 

156 

&CE0 

157 

ScCE8 

158 

&CF0 

159 

&CF8 


EXPLODING USER-DEFINABLE CHARACTER RAM 

It is possible to re-define any of the ASCII character codes. Before 
doing so, however, RAM must be made available for them by 
exploding it. To do this the *FX20 call is implemented. The new 
ASCII codes available and the RAM used are as follows: 
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*FXcall 

ASCII codes available 

Memory used 

*FX20,0 

128 to 159 

&C00 to&CFF 

*FX20,1 

as *FX20,0 plusl60 to 191 

OSHWM to 

OSHWM 4- &FF 

*FX20,2 

as: *FX20,1 plus 192 to 223 

as above to 
OSHWM + &1FF 

*FX20,3 

as *FX20,2 plus 224 to 255 

as above to 
OSHWM + &2FF 

*FX20,4 

as *FX20,3 plus 32 to 63 

as above to 
OSHWM + &3FF 

*FX20,5 

as *FX20,4 plus 64 to 95 

as above to 
OSHWM +&4FF 

*FX20,6 

as *FX20, 5 plus 96 to 127 

as above to 
OSHWM &5FF 


READING CHARACTER DEFINITIONS 

The bit-pattem definition given to any ASCII character code may 
be read using an OSWORD call with the accumulator containing &A. 
The index registers point to a nine-byte parameter block in which 
the ASCII code definition is to be returned. The first byte of the 
parameter block should contain the ASCII code of the character to 
be read. The following eight bytes contain the character definition. 
Using this call, the definition of A can be read thus: 


10 

A% = 

&A 

20 

x% - 

&70 

30 

Y% = 

0 

40 

?S:70 

= ASC 

50 

CALL 

&FFF1 


On return the addresses &71 to &78 contain the following bytes: 


Location 

Contents 

Bit pattern 

8c71 

&3C 

00111100 

&:72 

8c66 

01100110 

&73 

8=66 

01100110 

&74 

8c7E 

01111110 

&75 

8:66 

01100110 

&76 

8=66 

01100110 

&77 

8=66 

01100110 

&78 

8=00 

00000000 
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19 Variable Storage 


The BBC Micro can handle two types of variable, namely: integer 
and real or floating point. Examples of each, as they would appear 
in a BASIC program are: 

10 BYTE% = 256 : REM An integer variable 
20 REAL = 3.14: REM Floating point 

Integer variables are signified by the % sign tagged onto the end. 
This is absent in real variables. The following table summarises 
both types: 


Aspect 

Integer 

Real 

Example 

256 

3.14 

Type 

Ahc% 

borrow 

Maximum value 

2 , 147, 483 . 647 

1.70141183 » 10E38 

Minimum value 

-2, 147, 483, 648 

-1.70141183 * 10.E38 

Accuracy 

1 unit 

9 sig. fig 

Memory storage 

4 bytes 

5 bytes 


All variable names may contain as many characters, upper or lower 
case, as required but must not start with a BASIC keyword. Thus 
VALUE% is illegal because of BASIC's VAL function. However. 
val% is legal. All variable names must start with a letter. 


RESIDENT INTEGER VARIABLES 

BASIC is supplied with 26 resident integer variables. These are A% 
to Z%. each being allocated four bytes of block zero RAM: 
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Variable 


Associated bytes 


AX 

404 

405 

406 

407 

BX 

408 

409 

40A 

40B 

CX 

40C 

40D 

40E 

40F 

DX 

410 

411 

412 

413 

EX 

414 

415 

416 

417 

FX 

418 

419 

41A 

41B 

GX 

41C 

41D 

41E 

41F 

HX 

420 

421 

422 

423 

IX 

424 

425 

426 

427 

JX 

428 

429 

42A 

42B 

KX 

42C 

42D 

42E 

42F 

LX 

430 

431 

432 

433 

MX 

434 

435 

436 

437 

NX 

438 

439 

43A 

43B 

□X 

43C 

43D 

43E 

43F 

PX 

440 

441 

442 

443 

QX 

444 

445 

446 

447 

RX 

448 

449 

44A 

44B 

SX 

44C 

44D 

44E 

44F 

TX 

450 

451 

452 

453 

UX 

454 

455 

456 

457 

VX 

458 

459 

45A 

45B 

MX 

45C 

45D 

45E 

45F 

XX 

460 

461 

462 

463 

YX 

464 

465 

466 

467 

ZX 

468 

469 

46A 

46B 


Figure 19.1 Integer variables—storage locations. 


VARIABLE POINTERS 

Page 4 of block zero RAM contains address pointers for each 
character which may start the definition of a variable name. In 
other words, the letters A to Z and a to z have two associated bytes 
in this area which point to the memory address where the first 
variable using the character is stored. Non-used characters contain 
&0000 in the associated bytes. 
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The bytes associated with each are: 


Character 

LSB address 

MSB address 

A 

&482 

&483 

B 

&484 

&485 

C 

&486 

&487 

D 

&488 

&489 

E 

&48A 

&48B 

F 

&48C 

&48D 

G 

&48E 

8:48F 

H 

&490 

&491 

I 

&492 

&493 

J 

&494 

&495 

K 

&496 

8=497 

L 

&498 

8=499 

M 

&49A 

8c49B 

N 

&49C 

8c49D 

0 

&49E 

8=49F 

P 

&4A0 

8c4Al 

Q 

&4A2 

8c4A3 

R 

&4A4 

8c4A5 

S 

&4A6 

8c4A7 

T 

&4A8 

8c4A9 

U 

&4AA 

8c4AB 

V 

&4AC 

8=4AD 

w 

S:4AE 

8c4AF 

X 

&4B0 

8=4B1 

Y 

&4B2 

8:4B3 

Z 

&4B4 

8c4B5 

a 

&4C2 

8c4C3 

b 

&4C4 

8c4C5 

c 

&4C6 

8c4C7 

d 

&4C8 

8=4C9 

e 

&4CA 

8c4CB 

f 

&4CC 

8=4 CD 

g 

&4CE 

8=4CF 

h 

&:4D0 

8=4D1 

i 

&4D2 

8=4D3 

j 

&4D4 

8=405 

k 

&4D6 

8=407 

1 

&4D8 

8=409 

m 

&4DA 

8=4DB 

n 

&4DC 

8=400 

0 

&4DE 

8=4DF 

P 

&4E0 

8=4E1 

q 

&4E2 

8=4E3 

r 

&4E4 

8=4E5 
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Character 

LSB address 

MSB address 

s 

&4E6 

&4E7 

t 

&:4E8 

&4E9 

u 

&4EA 

&4EB 

V 

&4EC 

&4ED 

w 

&:4EE 

&4EF 

X 

&4F0 

&4F1 

y 

&4F2 

&4F3 

z 

&4F4 

&4F5 


INTEGER STORAGE 

When run. the values assigned to integer variables are assembled 
above TOP in the following manner: 


1. A two-byte address pointing to the next integer variable 
starting with the same letter. High byte of address contains 0 if 
it is the last or only variable starting with that letter. 

2. The variable name including the % sign but excluding the first 
letter of the named variable. 

3. Zero-byte to mark end of variable name. 

4. Four bytes holding the value assigned to that variable. 

5. Next variable, or if no more, the variable type byte. 

REAL STORAGE 

When run the values assigned to real variables are assembled above 

TOP in the following manner: 

1. A two-byte address pointing to the next integer variable 
starting with the same letter. Contains 0 if it is the last or only 
variable starting with that letter. 

2. The variable name excluding the first letter of the named 
variable. 

3. Zero-byte to mark end of variable name. 

4. Five bytes holding the value assigned to that variable in 
floating point form. 

5. Next variable, or if no more, the variable type byte. 
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FLOATING POINT REPRESENTATION 

The BBC Micro uses a fairly standard representation of floating 
point numbers. Using five bytes to hold the sign, exponent and 
value in memory as follows: 


Memory + 0 
Memory + I 
Memory + 2 
Memory + 3 
Memory + 4 


Exponent 

Mantissa first byte. Bit 7 = sign bit 
Mantissa second byte 
Mantissa third byte 
Mantissa fourth byte 


The most significant byte of the mantissa is held at Memory + 1 and 
the least significant byte at Memory + 4. The numbers 0 to 10 in 
floating point form would be: 


0 

00 

00 

00 

00 

00 

1 

81 

00 

00 

00 

00 

2 

82 

00 

00 

00 

00 

3 

83 

40 

00 

00 

00 

4 

83 

00 

00 

00 

00 

5 

83 

20 

00 

00 

00 

6 

83 

40 

00 

00 

00 

7 

84 

60 

00 

00 

00 

8 

84 

00 

00 

00 

00 

9 

84 

10 

00 

00 

00 

10 

84 

20 

00 

00 

00 


A negative floating point number is represented in a similar 
manner but &80 is added to the second byte, therefore -5 would 
become: 

-5 : 83 A0 00 00 00 
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Part Two 
Assembler 




20 Binary and 
Hexadecimal 
Numbers 


Figure 20.1 lists the numeric equivalents for decimal, hexadecimal 
and binary numers from 0 to 15. 


Decimal 

Hex 

Binary 

0 

0 

0000 

1 

1 

0001 

2 

2 

0010 

3 

3 

0011 

4 

4 

0100 

5 

5 

0101 

6 

6 

0110 

7 

7 

0111 

8 

8 

1000 

9 

9 

1001 

10 

A 

1010 

11 

B 

1011 

12 

C 

1100 

13 

D 

1101 

14 

E 

1110 

15 

F 

1111 


Figure 20.1 Numeric equivalents. 


Bit numbering 

The eight bits in a byte are numbered from 0 to 7 as follows: 
76543210 
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21 The 6502 /6512 


The architecture of the 6502 (6512 for BBC B +) is shown in Figure 
21.1. All registers are eight-bit with the Program Counter being a 
two-byte address register. 



0 

Accumulator 


Index registers 


Status register 


Stack pointer 


Program counter 


Figure 21.1 Architecture of the microprocessor. 


THE STATUS REGISTER 

The flags of the Status register are illustrated in Figure 21.2. The 
function of each flag is detailed below. 


7 0 


N 

V 

- 

B 

D 

I 

Z 

C 


Figure 21.2 The Status register flags. 
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Bit 7 - The Negative flag-. In signed binary this flag determines the 
sign of a number. If N = 1 the number is negative; if N = 0 the 
number is positive. In general, the most significant bit of the result 
of an operation is copied directly here. 

Bit 6 - The Overflow flag-. This bit is used to determine whether a 
carry occurred from bit 6 during an addition, or conversely whether 
a borrow occurred from bit 6 during a subtraction. 

Bit 4 - The Break flag-. This flag is set whenever a BRK occurs. 

Bit 3 - The Decimal flag: Setting this bit with SED will cause the 
microprocessor to operate in BCD. 

Bit 2 - The Interrupt flag: This flag is set when the IRQ is disabled. 
Bit I - The Zero flag: This bit is set if the result of an operation is 
zero. 

Bit 0 - The Carry flag: This bit is set if the result of an operation is 
too large for eight bits. 
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22 The Instruction Set 


This section contains a full description of each of the 56 instructions 
that the 6502 and. in the case of the BBC B+ the 6512. 
microprocessor is provided with. For ease of reference, the 
instructions are arranged in alphabetical order by mnemonic, and 
each description is broken down into the following four sections. 

Introduction A brief one- or two-line description of the 
instruction’s function. 

Table This details the addressing modes available with the 
instruction, and lists the various opcodes, the total number of 
memory bytes required by each addressing mode, and finally the 
number of cycles that particular addressing mode takes to 
complete. 

Status Shows the effect the execution of the instruction has on the 
Status register. The following codes are employed: 

* The flag is affected by the instruction but bits are 
undefined, being dependent on the byte’s contents 

1 The flag is set by the instruction 

0 The flag is cleared by the instruction 


If no code is indicated the flag remains unaltered by the instruction. 

Operation A brief description of how the instruction operates 
together with details of its effect on the Status register. 
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ADC 

Add memory to accumulator with carry. 


Addressing 

Opcode 

Bytes 

Cycles 

ADC #immediate 

&69 

2 

2 

ADC zero page 

&65 

2 

3 

ADC zero page, X 

&75 

2 

4 

ADC absolute 

&6D 

3 

4 

ADC absolute, X 

&7D 

3 

4/5 

ADC absolute, Y 

&79 

3 

4/5 

ADC (zero page, X) 

&61 

2 

6 

ADC (zero page), Y 

&71 

2 

5/6 


N V — B D I z c 
* * * * 


Operation Adds the contents of the specified memory location to 
the current contents of the accumulator. If the Carry flag is set this 
is added to the result which is then stored in the accumulator. If the 
result is greater than &FF (255) the Carry flag is set. If the result is 
equal to zero the Zero flag is set. The contents of bit 7 of the 
accumulator are copied into the Status register. If overflow 
occurred from bit 6 to bit 7 the Overflow flag is set. 
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AND 

Logical AND of memory location with accumulator. 


Addressing 

Opcode 

Bytes 

Cycles 

AND #immediate 

&29 

2 

2 

AND zero page 

&25 

2 

3 

AND zero page, X 

&35 

2 

4 

AND absolute 

&2D 

3 

4 

AND absolute, X 

&3D 

3 

4/5 

AND absolute, Y 

&39 

3 

4/5 

AND (zero page, X) 

&21 

2 

6 

AND (zero page), Y 

&31 

2 

5/6 


N V — B D I Z C 
* * 


Operation Logically ANDs the corresponding bits of the 
accumulator with the specified value or contents of memory 
location. The result of the operation is stored in the accumulator 
but memory contents remain unaltered. If the result of the AND is 0, 
the Zero flag is set. If the result leaves bit 7 set. the Negative flag is 
set. Otherwise both flags are cleared. 
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ASL 

Shift contents of accumulator or memory left by one bit. 


Addressing 

Opcode 

Bytes 

Cycles 

ASL accumulator 

&0A 

1 

2 

ASL zero page 

&06 

2 

5 

ASL zero page, X 

&16 

2 

6 

ASL absolute 

&0E 

3 

6 

ASL absolute. X 

&1E 

3 

7 


N V — B D I Z C 

9ic >tc * 


Operation Shuffles the bits in a specified location one bit left. Bit 
7 moves into the carry, and a zero is placed into the vacated bit 0. 



The Carry flag is set if bit 7 contained a 1 before the shift, and 
cleared if it contained 0. The Negative flag is set if bit 6 previously 
contained a 1. The Zero flag is set if the location holds &00 after the 
shift. For this to occur it must previously have contained either 8c00 
or &80. 
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BCC 

Branch if the Carry flag is clear (C = 0). 


Addressing 

Opcode 

Bytes 

Cycles 

BCC relative 

&90 


1 

2/3/4 


N V — B D I 

Z C 



Operation If the Carry flag is clear (C = 0) the byte following the 
instruction is interpreted as a two’s complement number and is 
added to the current contents of the Program Counter. This gives 
the new address from which the program will now execute, 
allowing a branch of either 126 bytes back or 129 bytes forward. If 
the Carry flag is set (C = 1) the branch does not occur and the next 
byte is ignored by the 6502. 


BCS 

Branch if the Carry flag is set (C = 1). 


Addressing 

Opcodes 

Bytes 

Cycles 

BCS relative 

&B0 


2 

2/3/4 


N V — B D I Z 

C 



Operation If the Carry flag is set (C = 1) the byte following the 
instruction is interpreted as a two’s complement number and is 
added to the current contents of the Program Counter; this gives 
the new address from which the program will now execute, 
allowing a branch of either 126 bytes back or 129 bytes forward. If 
the Carry flag is clear (C = 0) the branch does not occur and the next 
byte is ignored by the 6502. 
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BEQ 

Branch if the Zero flag is set (Z = 1). 


Addressing 

Opcode 

Bytes 

Cycles 

BEQ relative 

&F0 


1 

2/3/4 


N V — B D I 

Z C 



Operation If the Zero flag is set (Z = 1) the byte following the 
instruction is interpreted as a two's complement number and is 
added to the current contents of the Program Counter; this gives 
the new program address from which the program will now 
execute, allowing a branch of either 126 bytes back or 129 bytes 
forward. If the Zero flag is clear (Z = 0) the branch does not occur 
and the next byte is ignored by the 6502. 


BIT 

Test memory bits. 


Addressing 

Opcode 

Bytes 

Cycles 

BIT zero page 

&24 

2 

3 

BIT absolute 

&2C 

3 

4 


N V — B D I Z C 
* * * 


Operation The BIT operation affects only the Status register; the 
accumulator and the specified memory location are unaltered. Bit 
7 and bit 6 of the memory byte are copied directly into N and V 
respectively. The Zero flag is conditioned after a logical bitwise 
AND between the accumulator and the memory byte. If 
accumulator AND memory results in zero then Z = 1. otherwise 
Z = 0. 
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BMI 

Branch if the Negative flag is set (N = 1). 


Addressing 

Opcode 

Bytes 

Cycles 

BMI relative 

&30 

2 

2/3/4 


N V — B D I 

Z C 



Operation Ifthe Negative flag is set (N = 1) the byte following the 
instruction is interpreted as a two’s complement number and is 
added to the current contents of the Program Counter; this gives 
the new address from which the program will now execute, 
allowing a branch of either 126 bytes back or 129 bytes forward. If 
the Negative flag is clear (N = 0) the branch does not occur and the 
next byte is ignored by the 6502. 


BNE 

Branch if the Zero flag is clear (Z = 0). 


Addressing 

Opcode 

Bytes 

Cycles 

BNE relative 

&D0 


2 

2/3/4 


N V — B D I 

Z C 



Operation If the Zero flag is clear (Z = 0) the byte following the 
instruction is interpreted as a two’s complement number and is 
added to the current contents of the Program Counter; this gives 
the new address from which the program will now execute, 
allowing a branch of either 126 bytes back or 129 bytes forward. If 
the Zero flag is set (Z = 1) the branch does not occur and the next 
byte is ignored by the 6502. 
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BPL 


Branch if the Negative flag is clear (N = 0). 


Addressing 

Opcode 

Bytes 

Cycles 

BPL relative 

&10 

2 

3/4/5 


N V — B D I 

Z C 



Operation If the Negative flag is clear (N = 0) the byte following 
the instruction is interpreted as a two's complement number and is 
added to the current contents of the Program Counter; this gives 
the new address from which the program will now execute, 
allowing a branch of either 126 bytes back or 129 bytes forward. If 
the Negative flag is set (N = 1) the branch does not occur and the 
next byte is ignored by the 6502. 


BRK 

Software forced BREAK. 


Addressing 

Opcode 

Bytes 

Cycles 

BRK implied 

&00 


1 

7 


N V — B D 1 

Z C 



1 


Operation The Program counter address plus one is pushed onto 
the stack, followed by the contents of the Status register. The Break 
flag is set and Beeb passes control to the BRK servicing routine at 
&FFFE. In Operating Systems later than version 1.0 the 
accumulator contents are saved in location &FC. (&DE for pre-OS 
1 . 0 ). 
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BVC 

Branch if the Overflow flag is clear (V = 0). 


Addressing 

Opcode 

Bytes 

Cycles 

BVC relative 

&50 

2 

2/3/4 


N V — B D I Z C 


Operation If the Overflow flag is clear (V = 0) the byte following 
the instruction is interpreted as a two's complement number and 
added to the current contents of the Program Counter. This gives 
the new address from which the program will now execute. This 
allows a branch of either 126 bytes back or 129 bytes forward. If the 
Overflow flag is set ("V = 1) the branch does not take place and the 
next byte is ignored by the 6502. 


BVS 

Branch if the Overflow flag is set (V = 1). 


Addressing 

Opcode 

Bytes 

Cycles 

BVS relative 

&70 

2 

2/3/4 


N V — B D I 

Z C 



Operation If the Overflow flag is set ("V = 1) the byte following the 
instruction is interpreted as a two's complement number and added 
to the current contents of the Program Counter. This gives the new 
address from which the program will now execute, allowing a 
branch of either 126 bytes back or 129 bytes forward. If the 
Overflow flag is clear CV = 0) the branch does not occur and the 
next byte is ignored by the 6502. 
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CLC 

Clear the Carry flag (C = 0). 


Addressing 

Opcode 

Bytes 

Cycles 

CLC implied 

&18 

1 

2 


N V — B D I z c 
Id 


Operation The Carry flag is cleared by setting it to zero. 
CLD 

Clear the Decimal flag (D = 0). 


Addressing 

Opcode 

Bytes 

Cycles 

CLD implied 

&D8 

1 

1 

2 


N V — B D I 

Z C 



0 


Operation The Decimal flag is cleared by setting it to zero. 
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CLI 

Clear the Interrupt flag (1 = 0). 


Addressing 

Opcode 

Bytes 

Cycles 

CLI implied 

&58 

1 

2 


N V — B D I z c 
0 


Operation The Interrupt flag is cleared by setting it to zero. 

CLV 

Clear the Overflow flag (V = 0). 


Addressing 

Opcode 

Bytes 

Cycles 

CLV implied 

&B8 

1 

2 


N V — B D I Z C 
0 


Operation The Overflow flag is cleared by setting it to zero. 
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CMP 

Compare contents of memory with contents of the accumulator. 


Addressing 

Opcode 

Bytes 

Cycles 

CMP ^immediate 

&C9 

2 

2 

CMP zero page 

&C5 

2 

3 

CMP zero page, X 

&D5 

2 

4 

CMP absolute 

&CD 

3 

4 

CMP absolute, X 

&DD 

3 

4/5 

CMP absolute, Y 

&D9 

3 

4/5 

CMP (zero page. X) 

&C1 

2 

6 

CMP (zero page), Y 

&D1 

2 

5/6 


N V — B D I Z C 
* * * 


Operation The contents of the specified memory location (or 
immediate value) are subtracted from the contents of the 
accumulator. The contents of the memory location and 
accumulator are not altered, but the Negative, Zero and Carry flags 
are conditioned according to the result of the subtraction. To 
perform this subtraction, the 6502 first sets the Carry flag and then 
adds the two's complement value of the memory location's 
contents to the accumulator's contents. If both values are equal 
(memory = accumulator) the Zero flag is set and the Carry flag 
remains set. If the contents of memory are less than the 
accumulator (memory < accumulator) the Zero flag is cleared and 
the Carry flag set. If memory contents are greater than the 
accumulator (memory > accumulator) then both the Zero flag and 
Carry flag are cleared. If unsigned binary is being used the Negative 
flag is also set. If signed binary is being used the Overflow flag 
should be checked in conjuction with the Negative flag to test for a 
'true' negative result. 
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CPX 

Compare contents of memory with contents of the X register. 


Addressing 

Opcode 

Bytes 

Cycles 

CPX #immediate 

&E0 

2 

2 

CPX zero page 

&E4 

2 

3 

CPX absolute 

&EC 

3 

4 


N V — B D I z c 

* >l« * 


Operation The contents of the specified memory location (or 
immediate value) are subtracted from the contents of the X 
register. The contents of the memory location and X register are not 
altered, instead the Negative, Zero and Carry flags are conditioned 
according to the result of the subtraction. To perform this 
subtraction the 6502 first sets the Carry flag and then adds the two’s 
complement value of the memory location to the contents of the X 
register. If both values are equal (memory = X register) the Zero 
flag is set and the Carry flag remains set. If the contents of the 
memory are less than the X register (memory < X register) the Zero 
flag is cleared but the Carry flag remains set. If memory contents 
are greater than the X register (memory > X register) then both 
Zero and Carry flags are cleared. If unsigned binary is being used 
then the Negative flag is set. 
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CPY 


Compare contents of memory with contents of the Y register. 


Addressing 

Opcode 

Bytes 

Cycles 

CPY ^immediate 

&C0 

2 

2 

CPY zero page 

&C4 

2 

3 

CPY absolute 

&CC 

3 

4 


N V — B D I Z C 
* * * 


Operation The contents of the specified memory location (or 
immediate value) are subtracted from the contents of the Y 
register. The contents of the memory location and Y register are not 
altered, instead the Negative, Zero and Carry flags are conditioned 
according to the result of the subtraction. To perform this 
subtraction the 6502 first sets the Carry flag and then adds the two’s 
complement value of the memory location to the contents of the Y 
register. If both values are equal (memory = Y register) the Zero 
flag is set and the Carry flag remains set. If the contents of the 
memory are less than the Y register (memory < Y register) the Zero 
flag is cleared but the Carry flag remains set. If memory contents 
are greater than the Y register (memory > Y register) then both 
Zero and Carry flags are cleared. If unsigned binary is being used 
then the Negative flag is set. 
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DEC 

Decrement memory contents by one. 


Addressing 

Opcode 

Bytes 

Cycles 

DEC zero page 

&C6 

2 

5 

DEC zero page, X 

&D6 

2 

6 

DEC absolute 

&CE 

3 

6 

DEC absolute, X 

&DE 

3 

7 


N V — B D I z c 

sK 9ic 


Operation The byte at the address specified is decremented by 
one (MEMORY = MEMORY — 1). If the result of the operation is 
zero the Zero flag will be set. Bit 7 of the byte is copied into the 
Negative flag. 


DEX 

Decrement contents of X register by one. 


Addressing 

Opcode 

Bytes 

Cycles 

DEX implied 

&CA 

1 

2 


N V — B D I 

Z C 



* * 


Operation One is subtracted from the value currently held in the 
X register (X = X- 1). If the result of the operation is zero the Zero 
flag will be set. Bit 7 is copied into the Negative flag (N = 0 if X < 
&80 ; N = 1 if X > &7F). The Carry flag is not affected by the 
instruction. 
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DEY 


Decrement contents of Y register by one. 


Addressing 

Opcode 

Bytes 

Cycles 

DEY implied 

&88 

1 

2 


N V — B D z c 

* >|c 


Operation One is subtracted from the value currently held in the 
Y register (Y = Y — 1). If the result of the operation is zero the Zero 
flag is set. Bit 7 is copied into the Negative flag (N = 0 if Y < 8c80 : N 
= 1 if Y > &7F). The Carry flag is not affected by the instruction. 


EOR 

Accumulator exclusively ORed with memory. 


Addressing 

Opcode 

Bytes 

Cycles 

EOR #immediate 

&49 

2 

2 

EOR zero page 

&45 

2 

3 

EOR zero page, X 

&55 

2 

4 

EOR absolute 

&4D 

3 

4 

EOR absolute, X 

&5D 

3 

4/5 

EOR absolute, Y 

&59 

3 

4/5 

EOR (zero page, X) 

&41 

2 

6 

EOR (zero page), Y 

&51 

2 

5/6 


N V — B D Z C 
* * 


Operation Performs a bitwise exclusive OR between the 
corresponding bits in the accumulator and the specified memory 
byte. If the result, which is stored in the accumulator, is zero the 
Zero flag is set. Bit 7 is copied into the Negative flag. 
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INC 

Increment memory contents by one. 


Addressing 

Opcode 

Bytes 

Cycles 

INC zero page 

&E6 

2 

5 

INC zero page, X 

&F6 

2 

6 

INC absolute 

&EE 

3 

6 

INC absolute, X 

&FE 

3 

7 


N V — B D I Z C 
* * 


Operation The byte at the address specified is incremented by 
one. If the address holds zero after the operation the Zero flag is 
set. Bit 7 of the byte is copied into the Negative flag. 


I NX 

Increment contents of X register by one. 


Addressing 

Opcode 

Bytes 

Cycles 

INX implied 

&E8 

1 

1 

2 


N V — B D I 

Z C 



« * 


Operation One is added to the value currently in the X register (X 
= X + 1). If the result of the operation is zero the Zero flag will be 
set. Bit 7 is copied into the Negative flag (N = 0 if X < &80 ; N = 1 if 
X > &7F). The Carry flag is not affected by the instruction. 
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INY 

Increment contents of Y register by one. 


Addressing 

Opcode 

Bytes 

Cycles 

INY implied 

&C8 

1 

2 


N V — B D 1 

Z C 



* * 


Operation One is added to the value currently held in the Y 
register (Y = Y + 1). If the result of the operation is zero the Zero 
flag will be set. Bit 7 is copied into the Negative flag. The Carry flag 
is not affected. 


JMP 


Jump to a new location. 


Addressing 

Opcode 

Bytes 

Cycles 

JMP absolute 

&4C 

3 

3 

JMP (indirect) 

&6C 

3 

3 


N V — B D I z c 


Operation In an absolute JMP the two bytes following the 
instruction are placed into the Program Counter. In an indirect 
jump the two bytes located at the two byte address following the 
instruction are loaded into the Program Counter. 
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JSR 

Jump, save return address. 


Addressing 

Opcode 

Bytes 

Cycles 

JSR absolute 

&20 

3 

6 


N V — B D I 

Z C 



Operation Acts as a subroutine call, transferring program control 
to another part of memory until an RTS is encountered. The 
current contents of the Program Counter plus two are pushed onto 
the stack. The Stack Pointer is decremented twice. The absolute 
address following the instruction is placed into the Program 
Counter and program execution continues from this new address. 


LDA 

Load the accumulator with the specified byte. 


Addressing 

Opcode 

Bytes 

Cycles 

LDA #immediate 

&A9 

2 

2 

LDA zero page 

&A5 

2 

3 

LDA zero page, X 

&B5 

2 

4 

LDA absolute 

&AD 

3 

4 

LDA absolute, X 

&BD 

3 

4/5 

LDA absolute, Y 

&B9 

3 

4/5 

LDA (zero page, X) 

&A1 

2 

6 

LDA (zero page), Y 

&B1 

2 

5/6 


N V — B D I Z C 
* * 


Operation Places the value immediately following the instruc¬ 
tion, or the contents of the location specified after the instruction, 
into the accumulator. If the value loaded is zero then the Zero flag 
is set. Bit 7 is copied into the Negative flag position. 
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LDX 


Load the X register with the specified byte. 


Addressing 

Opcode 

Bytes 

Cycles 

LDX (/immediate 

&A2 

2 

2 

LDX zero page 

&A6 

2 

3 

LDX zero page, Y 

&B6 

2 

4 

LDX absolute 

&AE 

3 

4 

LDX absolute, Y 

&BE 

3 

4/5 


N V — B D I z c 
* * 


Operation Places the value immediately following the 
instruction, or the contents of the location specified after the 
instruction, into the X register. If the value loaded is zero then the 
Zero flag is set. Bit 7 is copied into the Negative flag position. 


LDY 

Load the Y register with the specified byte. 


Addressing 

Opcode 

Bytes 

Cycles 

LDY #immediate 

&A0 

2 

2 

LDY zero page 

&A4 

2 

3 

LDY zero page, X 

&B4 

2 

4 

LDY absolute 

&AC 

3 

4 

LDY absolute, X 

&BC 

3 

4/5 


N V — B D I Z C 
* « 


Operation Places the value immediately following the 
instruction, or the contents of the location specified after the 
instruction, into the Y register. If the value loaded is zero the Zero 
flag is set. Bit 7 is copied into the Negative flag. 
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LSR 

Logically shift the specified byte right one bit. 


Addressing 

Opcode 

Bytes 

Cycles 

LSR accumulator 

&4A 

1 

2 

LSR zero page 

&46 

2 

5 

LSR zero page, X 

&56 

2 

6 

LSR absolute 

&4E 

3 

6 

LSR absolute, X 

&5E 

3 

7 


N V — B D 1 Z C 
0 * * 


Operation Moves the contents of the specified byte right by one 
position, putting a 0 in bit 7 and bit 0 into the Carry flag. 



The Negative flag is cleared, and the Carry flag is conditioned by 
the contents of bit 0. The Zero flag is set if the specified byte now 
holds zero (in which case it must previously have contained &00 or 
& 01 ). 
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NOP 


No operation 


Addressing 

Opcode 

Bytes 

Cycles 

NOP implied 

&EA 

1 

2 


N V — B D I Z C 


Operation Does nothing except increment the Program Counter. 


ORA 


Logical OR of a specified byte with the accumulator. 


Addressing 

Opcode 

Bytes 

Cycles 

ORA ^immediate 

&09 

2 

2 

ORA zero page 

&05 

2 

3 

ORA zero page. X 

&15 

2 

4 

ORA absolute 

%0D 

3 

4 

ORA absolute, X 

&1D 

3 

4/5 

ORA absolute, Y 

&19 

3 

4/5 

ORA (zero page, X) 

&01 

2 

6 

ORA (zero page), Y 

&11 

2 

5/6 


N V — B D I Z C 
* * 


Operation Logically ORs the corresponding bits of the 
accumulator with the specified value, or contents of a memory 
location. The result of the operation is stored in the accumulator. If 
the result leaves bit 7 set the Negative flag is set, otherwise it is 
cleared. 
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PHA 

Push the accumulator contents onto the 'top' of the stack. 


Addressing 

Opcode 

Bytes 

Cycles 

PHA implied 

&48 

1 

3 


N V — B D I z c 


Operation The contents of the accumulator are copied into the 
position indicated by the Stack Pointer.The Stack Pointer is then 
decremented by one. 


PHP 


Push the Status register’s contents onto the top of the stack. 


Addressing 

Opcode 

Bytes 

Cycles 

PHP implied 

&08 

1 

3 


N V — B D I Z C 


Operations The contents of the Status register are copied into the 
position indicated by the Stack Pointer. The Stack Pointer is then 
decremented by one. 
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PLA 


Pull the 'top' of the stack into the accumulator. 


Addressing 

Opcode 

Bytes 

Cycles 

PLA implied 

&68 

1 

4 


N V — B D I Z C 
* * 


Operation The Stack Pointer is incremented by one, and the byte 
contained at this position in the stack is copied into the 
accumulator. If the byte is &00 the Zero flag is set. Bit 7 is copied 
into the Negative flag. 


PLP 

Pull the ‘top’ of the stack into the Status register. 


Addressing 

Opcode 

Bytes 

Cycles 

PLP implied 

&28 

1 

4 


N V — B D 1 Z C 

« 9tc * « * 4c * 


Operations The Stack Pointer is incremented by one and the byte 
contained at this position is copied into the Status register. 
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ROL 

Rotate either the accumulator or a memory byte left by one bit with 
the Carry flag. 


Addressing 

Opcode 

Bytes 

Cycles 

ROL accumulator 

&2A 

1 

2 

ROL zero page 

&26 

2 

5 

ROL zero page, X 

&36 

2 

6 

ROL absolute 

&2E 

3 

6 

ROL absolute, X 

&3E 

3 

7 


N V — B D I Z C 
* ♦ * 


Operation The specified byte and the contents of the Carry flag 
are rotated left by one bit in a circular manner. 



Bit 7 is rotated into the Carry flag, with the flag’s previous contents 
moving into bit 0. The remaining bits are shuffled left. The 
Negative flag is set if bit 6 previously held 1; cleared otherwise. The 
Carry flag is conditioned by bit 7. and if the specified byte now 
holds zero the Zero flag is set. 
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ROR 


Rotate either the accumulator or a memory byte right by one bit 
with the Carry flag. 


Addressing 

Opcode 

Bytes 

Cycles 

ROR accumulator 

&6A 

1 

2 

ROR zero page 

&66 

2 

5 

ROR zero page, X 

&76 

2 

6 

ROR absolute 

&6E 

3 

6 

ROR absolute, X 

&7E 

3 

7 


N V — B D I Z C- 

« >t: * 


Operation The specified byte and the contents of the Carry flag 
are rotated right by one bit in a circular manner. 



Bit 0 is rotated into the Carry flag with the flag’s previous contents 
moving into the bit 7 position. The remaining bits are shuffled 
right. The Negative flag is set if the Carry flag was set previously; 
otherwise it is cleared. If bit 0 contained a 1 the Carry flag will now 
also be set. If the specified byte now holds zero the Zero flag is set. 
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RTI 

Return from interrupt. 


Addressing 

Opcode 

Bytes 

Cycles 

RTI implied 

&40 

1 

6 


N V — B D I Z C 

* Hn 9|e « # 


Operation This instruction expects to find three bytes' on the 
stack. The first byte is pulled from the stack and placed into the 
Status register—thus conditioning all flags. The next two bytes are 
placed into the Program Counter. The Stack Pointer is 
incremented as each byte is pulled. 


RTS 

Return from subroutine. 


Addressing 

Opcode 

Bytes 

Cycles 

RTS implied 

&60 

1 

6 


N V — B D I z c 


Operation The two bytes on the top of the stack are pulled, 
incremented by one, and placed into the Program Counter. 
Program execution continues from this address. The Stack Pointer 
is incremented by two. 
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SBC 


Subtract specified byte from the accumulator with borrow. 


Addressing 

Opcode 

Bytes 

Cycles 

SBC ^immediate 

&E9 

2 

2 

SBC zero page 

&E5 

2 

3 

SBC zero page, X 

&F5 

2 

4 

SBC absolute 

&ED 

3 

4 

SBC absolute, X 

&FD 

3 

4/5 

SBC absolute, Y 

&F9 

3 

4/5 

SBC (zero page, X) 

&E1 

2 

6 

SBC (zero page), Y 

&F1 

2 

5/6 


N V — B D I Z C 
* * * * 


Operation Subtracts the immediate value, or the byte contained 
at the specified address, from the contents of the accumulator. If 
the value is greater than the contents of the accumulator it will 
‘borrow’ from the Carry flag, which should be set at the onset 
(only) of a subtraction. If the Carry flag is clear after the 
subtraction, a borrow has occurred. If the result is &00 the Zero 
flag is set. The contents of bit 7 are copied into the negative flag and 
V is set if an overflow from bit 6 to bit 7 occurred. 


SEC 

Set the Carry flag (C = 1). 


Addressing 

Opcode 

Bytes 

Cycles 

SEC implied 

&38 

1 

2 


N V — B D I z c 
1 


Operation A one is placed into the Carry flag bit position. 
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SED 

Set the Decimal mode flag (D = 1). 


Addressing 

Opcode 

Bytes 

Cycles 

SED implied 

&F8 

1 

2 


N V — B D I Z c 
1 


Operation A one is placed into the Decimal flag position. 

SEI 

Set the Interrupt disable flag (1 = 1). 


Addressing 

Opcode 

Bytes 

Cycles 

SEI implied 

&78 

1 

2 


N V — B D I Z C 
1 


Operation A one is placed into the Interrupt flag position. 
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STA 

Store the accumulator’s contents in a memory location. 


Addressing 

Opcode 

Bytes 

Cycles 

STA zero page 

&85 

2 

3 

STA zero page, X 

&95 

2 

4 

STA absolute 

&8D 

3 

4 

STA absolute, X 

&9D 

3 

5 

STA absolute, Y 

&99 

3 

5 

STA (zero page, X) 

&81 

2 

6 

STA (zero page), Y 

&91 

2 

6 


N V — B D I z C 


Operation The contents of the accumulator are copied into the 
specified memory location. 


STX 


Store the X register’s contents in memory. 


Addressing 

Opcode 

Bytes 

Cycles 

STX zero page 

&86 

2 

3 

STX zero page, X 

&96 

2 

4 

STX absolute 

&8E 

3 

4 


N V — B D I Z C 


Operation The contents of the X register are copied into the 
specified memory location. 
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STY 

Store the Y register’s contents in memory. 


Addressing 

Opcode 

Bytes 

Cycles 

STY zero page 

&84 

2 

3 

STY zero page, X 

&94 

2 

4 

STY absolute 

&8C 

3 

4 


N V — B D I Z C 


Operation The contents of the Y register are copied into the 
specified memory location. 


TAX 

Transfer the accumulator’s contents into the X register. 


Addressing 

Opcode 

Bytes 

Cycles 

TAX implied 

&AA 

1 


2 


N V — B D I 

Z C 



He >|< 


Operation The contents of the accumulator are copied into the X 
register. If the X register now holds zero, the Zero flag is set. Bit 7 is 
copied into the Negative flag. 
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TAY 


Transfer accumulator’s contents into the Y register. 


Addressing 

Opcode 

Bytes 

Cycles 

TAY implied 

&A8 

1 

2 


N V — B D I Z C 
* * 


Operation The contents of the accumulator are copied into the Y 
register. If the Y register now holds zero the Zero flag is set. Bit 7 is 
copied into the Negative flag. 


TSX 

Transfer the Stack Pointer’s contents into the X register. 


Addressing 

Opcode 

Bytes 

Cycles 

TSX implied 

&BA 

1 

2 


N V — B D 1 

Z C 



* « 


Operation The contents of the Stack Pointer are copied into the X 
register. If X now holds zero, the Zero flag is set. Bit 7 is copied into 
the Negative flag. 
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TXA 

Transfer the X register’s contents into the acumulator. 


Addressing 

Opcode 

Bytes 

Cycles 

TXA implied 

&8A 

1 

2 


N V — B D 1 Z C 

Hit * 


Operation The contents of the X register are copied into the 
accumulator. If the accumulator now holds zero the Zero flag is set. 
Bit 7 is copied into the Negative flag. 


TXS 

Transfer the X register’s contents into the Stack Pointer. 


Addressing 

Opcode 

Bytes 

Cycles 

TXS implied 

&9A 

1 

2 


N V — B D I Z C 


Operation The contents of the X register are copied into the Stack 
Pointer. 
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TYA 


Transfer the Y register’s contents into the accumulator. 


Addresssing 

Opcode 

Bytes 

Cycles 

TYA implied 

&98 

1 

2 


N V — B D I Z C 
* * 


Operation The contents of the Y register are copied into the 
accumulator. If the accumulator now holds zero the Zero flag is set. 
Bit 7 is copied into the Negative flag. 
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23 EQJJ and Options 


The OPT statement is used to control the type of response the BBC 
Micro produces when encountering errors during assembly. In all 
there are eight uses, the first four of which are most commonly 
used: 

OPT 0 No assembly listing and all errors suppressed. 

OPT 1 Assembly listing produced but all errors suppressed. 

OPT 2 No assembly listing but all errors reported. 

OPT 3 Assembly listing produced and all errors reported. 

The next four OPT commands are for use with dual assembly using 
0 %: 

OPT 4 As OPT 0 but uses 0%. 

OPT 5 As OPT 1 but uses 0 %. 

OPT 6 As OPT 2 but uses 0%. 

OPT 7 As OPT 3 but uses 0%. 

EQU functions 

BASIC 2 contains four pseudo-mnemonics that allow bytes, words, 
double words and strings to be assembled. These are detailed 
below. 

EQUB 

Store a byte of data in memory. 

Use EQUB & 0D\ place RETURN here 

EQUB 255\place 255 (&FF) here 

Operation Pokes a single byte of data into memory at the current 
memory location as defined by P%. Data is stored in hexadecimal 
format internally, but EQUB data may be either hexadecimal or 
decimal. 
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EQUD 

Store four bytes of data in memory. 

Use EQUD &12345678 
EQUD 12345678 

Operation Pokes four bytes of data into consecutive memory 
locations as defined by the current contents of P%, which is then 
incremented by four. Data is stored internally in hex format but 
EQUD data may be specified in hex or decimal. EQUD data is entered 
into memory in reverse order, thus the command: 

EQUD &12345678 

would be stored in consecutive bytes as: 

&78, &56, &34, &12 

EQUW 

Store two bytes of data into memory. 

Use EQUW &0D07 
EQUW32123 

Operation Pokes two bytes of data into consecutive memory 
locations as defined by the current contents of P%, which is then 
incremented by two. Data is stored internally in hex format but 
EQUW data may be specified in hex or decimal. EQUW data is entered 
into memory in reverse order, thus the command: 

EQUD &0D07 

would be stored in consecutive bytes as, 

&07, &0D 

EQUS 

Store ASCII string in memory. 

Use EQUS “BBC Micro” 

Operation Converts an ASCII string of characters within 
quotation marks into hexadecimal codes and pokes them into 
successive memory locations. The quotation marks are stripped 
and not included. The value of P% is incremented by the number 
of characters in the string. 
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Part Three 
TheMOS 




24 Memoiy Map 



FFFF 

FF00 

FC00 

C000 

8000 


1900 

0E00 

0000 


Figure 24.1 BBC B memory map. 
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Paged 

Paged 

Paged 

ROM 

ROM 

ROM 


Figure 24.2 BBC B+ memory map. 
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ROM workspace pointers 

ROM vectors 

NMI handler 

User-definable characters 

Function key buffer 

CFS and RS423 input buffer 

CFS and RS423 output buffer 

Buffers 

Language 

workspace 

Variable pointers and workspace 

VDU and CFS workspace 

Vectored Addresses 

Hardware stack 

MOS pointers 

VDU workspace 

Filing system workspace 

MOS workspace 

Econet workspace 

Language workspace 


0E00 

0DF0 

0D9F 

0D00 

0C00 

0B00 

0A00 

0900 

0800 


0500 

0400 

0300 

0200 

0100 

00E2 

00D0 

00B0 

00A0 

0090 

0000 


Figure 24.3 MOS and BASIC workspace memory map. 




25 Operating System 
Commands 


The Operating System commands form part of the Machine 
Operating System (MOS) and they are signified by an asterisk 
prefix. Unlike BASIC commands they are stored in memory in 
their ASCII form and are not tokenised. On recognising an OS 
command, the current language hands the rest of the line to the 
MOS for interpretation. It is for this reason that OS commands 
should be confined to separate lines or, at least, be the last 
command on a multi-statement line. For similar reasons BASIC 
variables may not be used to form parameters in OS commands, as 
these are not recognised by the MOS interpreter. 


THE COMMANDS 

The following is a list of OS commands available to all models of 
the BBC Micro and includes details of any parameters required: 

♦ BASIC 

♦ CAT 

♦CODE X%,Y% 

♦EXEC filename 
♦FX A%,X%,Y% 

♦HELP 

♦KEY n (string) 

♦LINE (string) 

♦LOAD filename, (address) 

♦MOTOR n 
♦OPT X%, Y% 

♦ROM 
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*RUN filename 

♦SAVE filename start end (execution) 
♦SPOOL filename 
♦TAPE n 
♦TV X%, Y% 

The following syntax has been used: 



filename 

n 

string 

address 

start 

end 

execution 


Value passed into accumulator 
Value passed into X register 
Value passed into Y register 
Specify name of file 
Number 

String of characters 
Hexadecimal address 
Hexadecimal address of start 
Hexadecimal address of end 
Hexadecimal address for ♦RUN 


MINIMUM ABBREVIATIONS 

OS commands may be abbreviated in the usual manner; the 
following table lists the minimum abbreviations: 


Command Abbreviation 


♦BASIC 

♦B. 

♦ CAT 

♦. 

♦ CODE 

♦ CO 

♦EXEC 

♦E. 

♦ FX 

♦ F. 

♦HELP 

♦H. 

♦KEY 

*K. 

♦ LINE 

♦LI 

♦LOAD 

♦L. 

♦MOTOR 

♦M. 

♦ OPT 

♦ 0. 

♦ROM 

♦RO 

♦RUN 

*! 

♦ SAVE 

♦S. 
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Command Abbreviation 


*SP00L 

*SP 

*TAPE 

♦T. 

*TV 

*TV 


THE BBC B+ 

The BBC B + supports an extra OS command which is used to turn 
the shadow screen memory on and off. The command is: 

*SHAD0Wx 

where x may be 0 or 1. 

^SHADOW 0 turns shadow RAM on 

♦SHADOW 1 turns shadow RAM off 

Note *SHAD0W is equivalent to ^SHADOW 0 and the video 
memory banking is only altered at the next mode change. The 
exception to this is in the case of the MODE 128 to 135 change. 
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26 Operating System 
Vectors 


The BBC Micro makes great use of vectored addresses which allow 
indirect jumps into the MOS to be performed. They also allow 
modifications to fundamental aspects of the Beeb’s operation as 
they may be used to intercept indirect jumps, control being directed 
to a wedge routine. (See BBC Micro Assembler Workshop for more 
details.) The vectors, their two-byte address and function are now 
listed: 


USERV&200, &201 
BRKV &202 , &203 
IRQ1V&204. &205 

IRQ2V&206, &207 

CLIV&208, &209 

BYTEV&20A, &20B 
WORDV&20C. &20D 
WRCHV&20E. &20F 


The USER Vector, ♦CODE and *LINE 
indirect through here. 

The software BReaK Vector used for error 
trapping, initiated by a BRK. 

Interrupt ReQuest Vector 1. This is the main 
interrupt vector through which the BBC 
Micro operates. It should only be altered 
with extreme care. 

The user IRQ Vector. Any interrupt 
requests not recognised by the MOS are 
directed through here so that they may be 
polled by the user if so required. 

The Command Line Interpreter Vector. 

All MOS commands are indirected through 
here. This enables paged ROMs to trap their 
own *commands. 

The OSBYTE Vector. All OSBYTE functions 
are indirected through here. 

The OSWORD Vector. All OSWORD functions 
are indirected through here. 

The OSWRCH Vector. All OSWRCH functions 
are indirected through here. 
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RDCHV&210, &211 
FILEV&212, &213 
ARGSV&214, &215 
BGETV&216, &217 

BPUTV&218, &219 

GBPBV&21A, &21B 

FINDV&21C, &21D 

FSCV&21E, &21F 

EVENTV&220, 8c221 
UPTV&222, 8:223 

NETV&224, &225 
VDUV 8:226, 8c227 
KEYV8:228, 8c229 


The OSRDCH Vector. All OSRDCH functions 
are indirected through here. 

The OSFILE Vector. All filing operations 
are indirected through here. 

The OSARGS Vector. All OSARGS functions 
are indirected through here. 

The OSBGET Vector. All OSBGET (including 
BASIC) functions are indirected through 
here. 

The OSBPUT Vector. All OSBPUT (including 
BASIC) functions are indirected through 
here. 

The OSGBPB Vector. All OSGBPB functions 
are indirected through here. 

The OSFIND Vector. All OSFIND functions 
are indirected through here. 

Indirection for various Filing System 
functions such as *RUN. 

EVENT polling is indirected through here. 

The User PrinT Vector. Indirection for 
software printer drivers for other languages, 
i.e. VIEW. 

The EcoNET Vector. Used by Econet for 
control purposes. 

The VDU Vector. All unrecognised VDU 
commands are indirected through here. 

The KEYboard Vector. All keyboard 
operations are indirected through here. 
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27 *FX/OSBYTE Calls 


OSBYTE&W *FX0 

Report Operating System details. 

OSBYTE &01 *FX 1 

Read or write to OSBYTE user flag. 

Y = 0 : To write 

Y = &FF : To read (See *FX 241.) 

The old value is returned in the X register. 


OSBYTE &02 *FX 2 


Define input stream. 

X = 0 : Keyboard 

X = 1 : RS423 

X = 2 : Keyboard and RS423 


On return the X register contains the previous input stream 
selected. 
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OSBYTE &03 *FX 3 

Define output stream. X = bit pattern to select. 

64 Cancel printer output, bar VDUl 

16 Cancel *SP00L 

8 Select printer output 

4 Cancel printer output 

2 Cancel VDU output 

1 Select RS423 

The old output stream status is returned in the X register. 


OSBYTE &04 *FX 4 
Cursor parameters. 

X = 0 : Default 

X = 1 : Cursor control keys produce ASCII codes 
X = 2 : Cursor control keys used as function keys 

On return the X register contains the previous setting. 


OSBYTE &05 *FX 5 
Define printer output. 


X = 0 

Ignore output 

X = 1 

Parallel 

X = 2 

RS423 

X = 3 

User print vector at &222 

X = 4 

Network vector at &224 

X >4 

AsX = 3 


On return the X register returns the previous setting 
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OSBYTE &06 


*FX 6 


Define printer disregard code. 

X = Character to be overlooked 
On return the X register holds the previous setting. 


OSBYTE &07 *FX 7 

Select RS423 input Baud rate. 

X = 1 : 75 Baud 

X = 2 : 150 Baud 

X = 3 : 300 Baud 

X = 4 : 1200 Baud 

X = 5 ; 2400 Baud 

X = 6 : 4800 Baud 

X = 7 : 9600 Baud 

X = 8 : 19200 Baud 

On return the index registers hold the old contents of the serial 
ULA register. 

OSBYTE &08 *FX 8 

Select RS423 output Baud rate. 

X = 1 : 75 Baud 

X = 2 : 150 Baud 

X = 3 : 300 Baud 

X = 4 : 1200 Baud 

X = 5 ; 2400 Baud 

X = 6 : 4800 Baud 

X = 7 : 9600 Baud 

X = 8 : 19200 Baud 

On return the index registers hold the old contents of the serial 
ULA register. 
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OSBYTE &09 *FX 9 

Set flash timing of (first) colours. 

X = 0: Infinity 
X =25: Default 

X = t: Where t = time in centiseconds 

On return the Y register contains the previous setting. 


OSBYTE &0A *FX 10 
Set flash timing of (second) colours. 





X 

= 0 : 

Infinity 

X 

= 25 : 

Default 

X 

= t : 

Where t = time in centiseconds 


On return the Y register contains the previous setting. 


OSBYTE &0B ^*^FX 11 

Set delay period of key auto-repeat. 

X = 0 : No auto-repeat 

X = 32 : Default value 

X = t : Where t = time in centiseconds 

On return the X register contains the previous setting. 

OSBYTE &0C *FX 12 

Set rate of key auto-repeat. 

X = 0 : No auto-repeat 

X = 8 : Default value 

X = t : Where t = time in centiseconds 

On return the X register contains the previous setting. 
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OSBYTE &0D 


^FX 13 


Disable event specified by X. 

X = 0 : Empty output buffer 
X = 1 : Full input buffer 

X = 2 : Buffer input 

X = 3 : ADC conversion 

X = 4 : Vertical sync. 

X = 5 ; Zero crossing of interval timer 

X = 6 : ESCAPE key 
X = 7 ; RS423 error 

X = 8 : Networking error 

X = 9 : User event 

On return, the index registers contain the previous enable state. 

OSBYTE &0E ^<^FX 14 

Enable event specified by X. 

X = 0 : Empty output buffer 

X = 1 : Full input buffer 

X = 2 : Buffer input 

X = 3 : ADC conversion 

X = 4 ; Vertical sync. 

X = 5 : Zero crossing of interval timer 

X = 6 : ESCAPE key 

X = 7 : RS423 error 

X = 8 : Networking error 

X = 9 ; User event 

On return, the index registers contain the previous enable state. 
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OSBYTE&0F *FX 15 

Clear contents of specified buffer(s). 

X = 0 : All buffers 

X > 0 : Input buffer only 

OSBYTE&10 *FX 16 

Defined ADC channels to be polled. 

X = 0 : No polling 

X = 1—4: Channel number selected 

On return, the X register contains the previous setting. 

OSBYTE&ll *FX 17 

Sample ADC channel specified. 

X = 1—4: To select channel number 

OSBYTE &12 *FX 18 

Clear contents of function keys. 

OSBYTE &13 *FX 19 

Pause till next vertical sync, signal. 

OSBYTE &14 *FX 20 

Explode user-defined character RAM. X selects memory 
allocation. (See Section 18 for details.) 

On return the X register contains the page setting of the new OSHWM 
value. 
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OSBYTE &15 


*FX 21 


Clear buffer specified by X. 

X = 0 : Keyboard buffer 

X = 1 : RS423 input buffer 

X = 2 : RS423 output buffer 

X = 3 : Printer buffer 

X = 4 ; Sound channel 0 

X = 5 : Sound channel 1 

X = 6 : Sound channel 2 

X = 7 : Sound channel 3 

X = 8 : Speech buffer 

OSBYTE &75 *FX n/a 

Read status of VDU. Result returned in bit pattern of X. Set bits flag 
the following conditions: 

7 VDU 21 operative 

6 Editing cursors separated 

5 VDU 5 operative 

4 Not used 

3 Text window operative 

2 Paged mode on 

1 Scrolling disabled 

0 VDU 2 operative 

OSBYTE &76 *FX n/a 

Return keyboard/LED status. 

X > 127 if CTRL pressed. (See OSBYTE &CA.) 

OSBYTE &77 *FX 119 

Close *EXEC or *SP00L files if any are open. 
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OSBYTE&78 *FX 120 

Write keys pressed details. (See Section 6.) 

OSBYTE&79 *FX n/a 

Scan keyboard for key. (See Section 6.) 

X = key EOR 8=80 

OSBYTE &7A *FX n/a 

As OSBYTE &79 but keyboard scan starts from &10. (See Section 
6 .) 

X = key EOR &80 

OSBYTE &7B *FX n/a 

Inform MOS of torpid printer driver. 

X = 3 : Printer identification code 

OSBYTE &7C *FX 124 

Clear ESCAPE flag. 

OSBYTE &7D *FX 125 

Set ESCAPE flag. 

OSBYTE &7E *FX 126 

Acknowledge ESCAPE condition. X returns ESCAPE flag 
condition. 

X = 0 : ESCAPE condition not acknowledged 

X = &FF : ESCAPE condition acknowledged 
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OSBYTE &7F 


*FX n/a 


Test for open files end. X holds file handle on entry to the call, and 
holds 0 if file end has not been reached. 


OSBYTE &80 *FX n/a 

Return value on ADC channel. X determines procedure. (See 
Section 41.) 

OSBYTE &81 *FX n/a 

Perform INKEY. Index registers specify time limit. 

X = t MOD 256 
Y = tDIV256 

On exit if Y = 0 then X = ASCII key code. 


OSBYTE &82 *FX n/a 

Read two high bytes of filing system address. On exit X and Y hold 
the address which will normally be &FFFF. 


OSBYTE &83 *FX n/a 

Read address of Operating System’s reserved RAM (normally 
PAGE). On exit the index registers hold the address generally 
known as OSHWM (OS High Water Mark). 


OSBYTE &84 ^FX n/a 

Read HIMEM address, returned in index registers. 
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OSBYTE&85 *FX n/a 

Read lowest address used for screen in a MODE specified by the X 
register. On return the index registers hold the address. 

OSBYTE &86 *FX n/a 

Perform POS and VPOS. On return X contains POS and Y, VPOS. 


OSBYTE &87 *FX n/a 

Read the character at cursor position. On return X holds the 
character or 0 if it does not recognise it. Y contains the current 
screen mode. 


OSBYTE &88 *FX 136 
Performs *C0DE. (See Section 24.) 


OSBYTE &89 *FX 137 

Performs *M0T0R with X determining state relay switched to. 

X = 1 : Switch motor on 

X = 0 : Switch motor off 

OSBYTE &8A *FX 138 

Insert character into buffer. X holds the buffer code (see 
OSBYTE &15) and Y the character to be inserted. 


OSBYTE &8B *FX 139 

Perform *0PT. X contains the option number and Y the parameter. 
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OSBYTE &8C 


*FX 140 


Perform *TAPE. X determines Baud transfer rate. 

X = 1 : Selects 1200 Baud 
X = 3 : Selects 300 Baud 

OSBYTE &8D ^^FX 141 
Perform *R0M. 


OSBYTE &8E *FX 142 

Select language ROM after a <BREAK> . X holds language ROM 
number. 


OSBYTE &8F *FX 143 

Service request on paged ROMs. X determines service type and Y 
its argument. 


OSBYTE &90 *FX 144 

Perform *TV. X holds the number of lines to shift vertically and Y 
determines interlace condition. 

Y = 1 : Interlace off 

Y = 0 : Interlace on 

OSBYTE &91 *FX n/a 

Return character from a buffer. X defines buffer (see 
OSBYTE &15) and Y returns the character. 


OSBYTE &92 *FX n/a 

Read FRED. X holds page offset, Y returns byte. 
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OSBYTE &93 *FX 147 

Write FRED. X holds page offset. Y contains byte to be written. 

OSBYTE &94 *FX n/a 

Read JIM. X holds page offset and Y returns byte. 

OSBYTE &95 *FX 149 

Write JIM. X contains page offset and Y holds byte to be written. 

OSBYTE &96 *fX n/a 

Read SHEILA. X contains page offset and Y returns byte. 

OSBYTE &97 *FX 151 

Write SHEILA. X contains page offset and Y holds byte to be 
written. 


OSBYTE &98 *FX n/a 

Examine contents of buffer. X specifies buffer code (see OSBYTE 
&15) and Y is cleared if buffer empty, otherwise it points to next 
character. 


OSBYTE &99 *FX 153 

Insert character into INPUT buffer. Y contains the character and X 
determines the buffer. 

X = 1 : RS423 

X = 0 : Keyboard 
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OSBYTE &9A 


*FX 154 


Write to video ULA. X contains value to be written to control 
register 0. 

OSBYTE &9B *FX 155 

Write contents of X to palette. Register 1 of video ULA. 

OSBYTE &9C *FX 156 

6850 ACIA read/write. Value written is: 

(Register value AND Y) EOR X 

On return the X register contains the previous register setting. 

OSBYTE &9D *FX 157 

Tube BPUT. Y contains the file handle and X the byte to be put. 
OSBYTE &9E *FX n/a 

Read speech processor. Must be used in conjunction with 
OSBYTE &9F. 


OSBYTE &9F *FX 159 

Write a byte to the speech processor. Y contains data. 


OSBYTE &A0 *FX n/a 

Read two consecutive bytes from VDU workspace in page 3. The X 
register contains the page offset and the index registers return the 
byte at X and X + 1. 
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OSBYTE &A8 *FX n/a 

Read paged ROM pointer table address. Address returned in 
index registers, normally &D9F. 


OSBYTE &AA *FX n/a 

Read paged ROM information table address. Address returned in 
index registers, normally &2A1. 


OSBYTE &AC *FX n/a 

Returns address of internal ASCII key code table in the index 
registers. 


OSBYTE &AE *FX n/a 

Returns address of VDU variable workspace in the index registers, 
normally &300. 


OSBYTE &B^ *FX n/a 

Read/write to cassette filing system’s ’timeout’ counter, returns 
former value in X. 'Value written is determined by: 

(Old value AND Y) FOR X 


OSBYTE &B1 *FX 177 
Performs as OSBYTE &02. 


OSBYTE &B2 *FX 178 

Read/write to keyboard semaphore. The old value is returned in X. 
the new value is determined by: 

(Old value AND Y) EOR X 
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OSBYTE &B3 


179 


Read/write to OSHWM as for imploded user-defined character 
buffer. The X register returns old value and the new PAGE value is 
determined by: 

(Old value AND Y) EOR X 


OSBYTE &B4 *FX 180 

Read/write to OSHWM. (See OSBYTE 8c83.) 


OSBYTE &B5 *FX 181 

Read/write RS423 operation mode. The old value is returned in X 
and the new value is determined by: 

(Old value ANDY) EORX 

This value toggles between 0 and 1. 

1 = ESCAPE and events are not detected (normal setting) 

0 = RS423 acts as keyboard 

OSBYTE &B6 *FX n/a 

Read user-defined character buffer condition. X returns the value. 
(See OSBYTE &14.) 


OSBYTE &B7 *FX 183 

CFS/ROM toggle. Allows selection between CFS and ROM filing 
system. The current value is returned in X. 

X =0: Cassette filing system 

X = 2 : ROM filing system 

This call returns 0 when DFS in use. 
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OSBYTE &BA *FX n/a 

Returns ROM number active at BRK, usually denoting an error. 
Value returned in X. 


OSBYTE &BB *FX n/a 

Returns paged ROM socket containing BASIC, normally 15. 
Value returned in X. 


OSBYTE &BC *FX n/a 

Returns current ADC channel in X register. 


OSBYTE &BD *FX n/a 

Returns maximum value of ADC channel number in X register. 


OSBYTE &BE *FX n/a 

Returns in X register ADC conversion type. 


X = 0 : 

Default, 12 bits 

X = 8 : 

Eight bits conversion 

X = 12 : 

Twelve bits conversion 

OSBYTE &BF 

*FX 191 


Read/write to RS423 operating flag. The old value is returned in X, 
and bit 7 determines state. 

1 = RS423 free 
0 = RS423 busy 
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OSBYTE &C0 *FX n/a 

Read RS423 control flag, value returned in X register. 


OSBYTE &C1 *FX 193 

Read/write to the colour flash counter. The X register returns the 
old value which is in l/50th second counts. 


OSBYTE &C2 *FX 194 

Read/write to first colour flash timing. (See OSBYTE &09.) 


OSBYTE &C3 *FX 195 

Read/write flash timing of (second) colour. (See OSBYTE &0A.) 


OSBYTE &C4 *FX 196 

Read/write value of keyboard auto-repeat delay. Old value is 
returned in the X register. This call is accessed by OSBYTE 8c0B. 


OSBYTE &C5 *FX 197 

Read/write period rate of keyboard auto-repeat. This call is 
accessed by OSBYTE &0C. 


OSBYTE &C6 *FX 198 

Read/write *EXEC file handle. The old value is returned in X 
register. 
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OSBYTE&C7 *FX 199 

Read/write *SPOOL file handle. The old value is returned in the X 
register. 


OSBYTE&C8 *FX 200 

Read/write effect of ESCAPE and BREAK. Bit 0 determines action 
on ESCAPE and bit 1 action on BREAK. 


B0 

= 0 : 

Normal ESCAPE 

B0 

= 1 : 

Disabled ESCAPE 

B1 

= 0 : 

Normal BREAK 

B1 

= 1 : 

Corrupt memory on BREAK 


OSBYTE&C9 *FX 201 

Enable/disable keyboard. Old value returned in X register by this 
call. If X = 0 on return keyboard acts normally, else it is locked. 


OSBYTE&CA *FX 202 


Read/write to keyboard action status. On return the X register 
returns old status byte. Bits 7 to 3 inclusive hold keyboard status 
details thus: 

B7 = 1 : SHIFT enabled 
B6 = 1 : CTRL detected 
B5 = 0 ; SHIFT-LOCK detected 
B4 = 0 : CAPS LOCK detected 
B3 = 1 : SHIFT detected 


OSBYTE&CB *FX 203 

Read/write buffer workspace available on RS423 handshake. On 
return X holds the old value which has a default of 9. 
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OSBYTE &CC 


*FX 204 


Read/write to RS423 input stifle flag. On return X contains the old 
value. If this is < > 0 then all input is ignored. 


OSBYTE &CD *FX 205 

Read/write to select RS423 output destination. The old value is 
returned in the X register. If it is 0 then output is to the RS423; if it is 
&40 output is routed to the CFS. 


OSBYTE &CE *FX 206 

Read/write to select Econet output routing. On return, the X 
register contains the old value. If bit 7 is set then all OSWORD and 
OSBYTE calls are directed via the Econet vector at &224. 


OSBYTE &CF *FX 207 

Read/write to select Econet input routing. On return, the old value 
is returned in the X register. If bit 7 is set then input is obtained 
through the Econet vector at &224. 


OSBYTE &D0 *FX 208 

Read/write to select Econet output routing. On return the old 
value is returned in the X register. If bit 7 is set then output is 
directed through the Econet vector at &224. 


OSBYTE &D1 *FX 209 

Read/write to speech processor enable/disable flag. On return the 
X register contains the old value. Writing &50 will enable speech, 
whereas &20 will disable speech. 
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OSBYTE&D2 *FX 210 

Read/write to SOUND enable/disable flag. On return the X register 
contains the old value. Any value other than 0 will disable SOUND. 


OSBYTE&D3 *FX 211 

Read/write BELL character channel number. The BELL channel 
(PRINT CHR$7 or CTRL G) has a default of 3. On return. X contains 
the old channel number. 


OSBYTE&D4 *FX 212 


Read/write BELL characters' SOUND details, either amplitude or 
ENVELOPE number. On return, the X register contains the old 
value. 


OSBYTE&D5 *FX 213 

Read/write value of BELL characters’ pitch. On return X contains 
old value. 


OSBYTE&D6 *FX 214 

Read/write duration of BELL character. On return. X register 
contains the old value. 


OSBYTE&D7 *FX 215 

Read/write to enable/disable OS reset messages. On return, the X 
register contains the old value. Bit 7 determines action. 

B7 = 1 : Then disable OS message 
B7 = 0 : Then enable OS message 
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OSBYTE &D8 


*FX 216 


Read/write to location containing current length of current 
function key. On return, the X register contains the old value. 


OSBYTE &D9 *FX 217 

Read/write the number of lines output in paged mode since last 
paged mode stop. 


OSBYTE &DA *FX 218 

Read/write number of items remaining in VDU call. On return, the 
X register contains the old value as a two’s complement value. 


OSBYTE &DB *FX 219 

Read/write TAB character value. On return, the X register contains 
the old value, which has a default of 9. i.e. forward one space. 


OSBYTE &DC *FX 220 

Redefine ESCAPE key. X contains ASCII code of key to be 

ESCAPE. On return the X register contains the old value. Default = 
27 

OSBYTE &DD ^^FX 221 

Set alternative interpretation of values &C0 to &CF 

OSBYTE &DE *FX 222 

Set alternative interpretation of values &D0 to 8=DF. 
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OSBYTE &DF *FX 223 

Set alternative interpretation of values &E0 to &EF. 

OSBYTE &E0 *FX 224 

Set alternative interpretation of values &:F0 to &FF. 

OSBYTE &E1 *FX 225 

Read/write function key status, keys or codes &80 to &8F. 

OSBYTE &E2 *FX 226 

Read/write function key + SHIFT key status, keys or codes 8c90 to 
&9F. 

OSBYTE &E3 *FX 227 

Read/write function key + CRTL key status, keys or codes &A0 to 
&AF. 


OSBYTE &E4 *FX 228 

Read/write function key + SHIFT + CTRL keys' status, keys or 
codes &B0 to &BF. 


OSBYTE &E5 *FX 229 

Read/write ESCAPE keys’ status. On return the X register contains 
the old value. If X returns 0 then ESCAPE has normal precedence. If 
X <> 0 then designated ESCAPE key treated as normal key 
function. 
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OSBYTE &E6 


*FX 230 


Read/write to ESCAPE action flag. On return the X register 
contains the old value. If X = 0, then escapes will be polled in 
normal manner. 


OSBYTE &E7 *FX 231 

Read/write to user VIA IRQ bit mask. Default = &FF. 

OSBYTE &E8 *FX 232 

Read/write to 6850 IRQ bit mask. Default = &FF. 

OSBYTE &E9 *FX 233 

Read/write to system VIA IRQ bit mask. Default = 8cFF. 

OSBYTE &EA *FX n/a 

Read Tube flag. On return the X register contains the old value. If 
X = 0 then Tube is not present. 

OSBYTE &EB *FX n/a 

Read speech processor flag. On return the X register contains the 
old value. If X = 0 processor absent. 

OSBYTE &EC *FX 236 

Read/write to character destination. This call is accessed bv 
OSBYTE &03. 
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OSBYTE &ED *FX 237 

Read/write to cursor flag. This call is accessed by OSBYTE &04. 
On return the X register contains the old value. 


OSBYTE &F1 *FX 241 

Read/write to user flag at &281. On return the X register contains 
the old value. 


OSBYTE &F2 *FX n/a 

Read serial ULA register, contents returned in X register. 

OSBYTE &F3 *FX n/a 

Read state of timer toggle. On return the X register contains the old 
value. 


OSBYTE &F4 *FX 244 

Read/write to function key access flag. On return, the X register 
contains the old value. 


OSBYTE &F5 *FX 245 

Read/write to printer destination flag. This call is accessed by 
OSBYTE &05. 

OSBYTE &F6 *FX 246 

Read/write the character to be ignored by printer output. This call 
is accessed by OSBYTE &06. 
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OSBYTE &F7 


*FX n/a 


Read/write BREAK jump code. On return the X register contains 
the old value which will normally be &4C. 


OSBYTE &F8 *FX n/a 

Read/write BREAK jump code. On return the X register contains 
the old value which will normally be &4C. 


OSBYTE &F9 *FX n/a 

Read/write BREAK jump code. On return the X register contains 
the old value which will normally be &4C. 

X = 2 : Hard BREAK 

X = 1 : Power up 

X = 0 : Soft BREAK 


OSBYTE &FE *FX 254 

Read RAM available flag. On return, the X register contains the 
old value. 

X = &40 : 16K 
X = &80 : 32K 


OSBYTE &FF *FX 255 

Read/write start up options, i.e. MODE and disc timing. Bits 0 to 2 
select MODE on BREAK. 
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OSBYTE AND THE BBC B PLUS 

The BBC B+ contains the 2.0 MOS which has some differences 
and additions to the standard 1.0/1.2 MOS. These differences are 
detailed below; 

OSBYTE &72 *FX 114 

This performs the equivalent of a *SHAD0W command. The X 
register should contain 0 or 1. The previous shadow state is 
returned in X after the call. Y returns the contents of location 
&280 . 


OSBYTE &73 *FX 115 

In 2.0 MOS, calls &72 to &A0 have been combined to form a single 
group. This call does nothing neither does it generate a ‘Bad 
command’ error. 


OSBYTE &74 ♦FX 116 

See above, OSBYTE &73. 

OSBYTE & 75 *FX 117 

As before but bit 4 is now used to return shadow status. 

OSBYTE &EF *FX 239 

This call acts like OSBYTE &72, but also provides a way of reading 
the ‘shadow’ bit without altering it! 

OSBYTE & FE *FX 254 

Read/write to available RAM. The B+ places a 1 here. 
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28 OSWORD Calls 


Operating system WORD call 

Entry address &FFF 1 

Vector WORDV &020C 

Entry details Accumulator = call code 

X Register = Low byte parameter address 

Y Register = High byte parameter address 

Commentary An OSWORD call is selected by a coding value 
contained within the accumulator. The index registers 
are used to pass the address of a parameter block in 
memory where data bytes can be extracted or placed 
by the OSWORD call. 

OSWORD calls 

Accumulator = 0 (Read input line to memory) 

Parameter bytes: 

XY + 0: LSB buffer address 

XY + 1: MSB buffer address 

XY + 2: Buffer length 

XY + 3: Minimum ASCII code accepted 

XY + 4: Maximum ASCII code accepted 

Exit conditions: 

Y = line length 

C = 1 if error <ESCAPE> detected 
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Accumulator 


Accumulator 


Accumulator 


Accumulator 


Accumulator 


1 (Read system TIME clock) 

Parameter bytes: 

XY + 0 = LSB TIME value 
XY+ 1 
XY + 2 
XY + 3 

XY + 4 = MSB TIME value 

2 (Write to system TIME clock) 

Parameter bytes: 

XY + 0 = LSB write value 

XY+ 1 

XY + 2 

XY + 3 

XY + 4 = MSB write value 

3 (Read event interval timer) 

Parameter bytes: 

XY + 0 = LSB value 

XY + 1 
XY + 2 
XY + 3 

XY + 4 = MSB value 

4 (Write event interval timer) 

Parameter bytes: 

XY + 0 = LSB write value 

XY+ 1 
XY + 2 
XY + 3 

XY + 4 = MSB write value 

■ 5 (Read byte of I/O memory across Tube) 
Parameter bytes: 

XY + 0 = LSB read address 

XY + 1 
XY + 2 

XY + 3 = MSB read address 
Exit conditions: 

XY + 4 = byte just read 

Notes: This call can be used in the BBC B + to read a 
byte from the paged RAM by setting the high bytes to 
&FFFE. 
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Accumulator = 6 (Write a byte to I/O memory across Tube) 
Parameter bytes: 

XY + 0 = LSB write address 

XY+ 1 
XY + 2 

XY + 3 = MSB read address 

XY + 4 = Byte to be written 
Notes: This call can be used to write a byte to the 
paged RAM in the BBC B + by setting the high bytes 
to &FFFE. 

Accumulator = 1 (Perform SOUND) 

Parameter bytes: 

XY + 0 = LSB channel 

XY + 1 = MSB channel 
XY + 2 = LSB amplitude 
XY + 3 = MSB amplitude 
XY + 4 = LSB pitch 
XY + 5 = MSB pitch 
XY + 6 = LSB duration 
XY + 7 = MSB duration 
Accumulator = 8 (Perform ENVELOPE) 

Parameter bytes: 

XY + 0 = Envelope number 

XY + 1 = Length of each step 

XY +2 = Change of pitch 1 

XY + 3 = Change of pitch 2 

XY + 4 = Change of pitch 3 

XY + 5 = Number of steps 1 

XY + 6 = Number of steps 2 

XY + 7 = Number of steps 3 

XY + 8 = Change of amplitude, attack 

XY + 9 = Change of amplitude, decay 

XY + 10 = Change of amplitude, sustain 

XY + 11 = Change of amplitude, release 

XY + 12 = Target of level, end of attack 

XY 4- 13 = Target of level, end of decay 


147 



Accumulator = 9 (Read value of pixel) 

Parameter bytes; 

XY + 0 = LSB X co-ordinate 

XY -I- 1 = MSB X co-ordinate 
XY + 2 = LSB Y co-ordinate 
XY -I- 3 = MSB Y co-ordinate 
Exit condition : 

XY + 4 = Logical colour of point (&FF if point 
off-screen) 

Accumulator = 10 (Read characters definition) 

Parameter bytes: 

XY -I- 0 = ASCII code of character 
XY -I- 1 = Top row of character bit pattern 
XY + 2 = Second row of character bit pattern. 


XY + 8 = Bottom row of character bit pattern 

Accumulator = \l (Read palette) 

Parameter bytes: 

XY 0 = Logical colour 

XY -t- 1 = Physical colour 
XY -1-2 = 0 padding for future expansion 
XY -I- 3 = 0 
XY + 4 = 0 

Accumlator = 12 (Write palette) 

Parameter bytes as for Accumulator 11 

Accumulator = 13 (Read last two graphics cursor positions) 
Parameter bytes: 

XY + 0 =LSB previous X co-ordinate 
XY -I- 1 = MSB previous X co-ordinate 
XY + 2 — LSB previous Y co-ordinate 
XY -I- 3 = MSB previous Y co-ordinate 
XY + 4 = LSB current X co-ordinate 
XY -I- 5 = MSB current X co-ordinate 
XY -I- 6 = LSB current Y co-ordinate 
XY + 7 = MSB current Y co-ordinate 
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29 Standard OS 
Calls 


OSRDCH (Operating System ReaD CHaracter call) 

Entry address &FFE0 

Vector WRCHV &0210 

Entry details None 

Commentary This routine reads a character from the active input 
stream into the accumulator. Any ESCAPES must be 
acknowledged with an OSBYTE call with the 
accumulator holding &7E. Any error detection will 
be signalled by a set Carry flag that will otherwise be 
clear. 

OSWRCH (Operating System WRite CHaracter call) 

Entry address &FFEE 

Vector WRCHV &020E 

Entry details Accumulator holds character 

Commentary This routine writes the character held in the accumu¬ 

lator to the currently active output stream(s) as 
defined by *FX 3. 

OSNEWL (Operating System NEW Line call 

Entry address &FFE? 

Vector Non vectored 

Entry details None 

Commentary This routine incorporates two OSWRCH calls to issue 

a linefeed and then a carriage return to the active 
output streamfs"). On completion the accumulator 
will hold &0D. 
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OSASCI (Operating System ASCII call) 

Entry address &FFE3 

Vector Not vectored 

Entry details Accumulator contains character to be written 
Commentary This routine uses the OSWRCH to write the accumu¬ 

lator’s contents to the currently selected output 
stream(s). If the accumulator holds 8c0D the routine 
will call OSNEWL to perform a linefeed and carriage 
return. 

OSCLI (Operating System Command Line Interpreter call) 

Entry address &FFF7 

Vector &0208 

Entry details X register: low-byte address 

Y register: high-byte address 

Commentary This routine passes a line of text, stored in ASCII 
form at the address given by the index registers and 
terminated by a carriage return (&0D), to the 
Operating System which will then interpret and 
execute the command. 

OSRDRM (Operating System ReaD byte from ROM call) 

Entry address &:FFB9 

Vector None 

Entry details Y register: ROM number 

Commentary This routine will read a byte from a ROM whose 

number is held in Y. The address in the ROM should 
be placed into the vector as &F6. The byte read is 
returned in the accumulator. 

B Plus Extra 

The BBC B+ contains two extra OS calls which are mirrored 
through OSRDRM. 
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OSRDSC (Operating System Read SCreen) 

Entry address &FFB9 

Vector None 

Entry details &F6 (LSB) and &F7 (MSB) should contain the ad¬ 
dress of the display location to be read. 

Commentary This routine will read a byte from the screen, or 
shadow screen, whichever is currently selected. In 
addition it can be used to read a byte from a ROM 
as described earlier or. if Y is greater than 127. from 
the paged RAM. This is therefore an alternative 
method to OSWORD Sc05. 

OSWRSC (Operating System WRite SCreen) 

Entry address &FFB3 

Vector None 

Entry details Accumulator contains byte to be written. &D6 

(LSB) and &D7 (MSB) contain the address byte to 
be written to. 

Commentary This routine will write a byte to the screen, or 
shadow screen, whichever is currently selected. 
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30 OS Filing System Calls 


OSFILE (Operating System FILE call) 

Entry address &FFDD 

Vector FILEV &0212 

Entry details Accumulator = file call select code 

X register = low-byte parameter block 
Y register = high-byte parameter block 

Commentary Allows a variety of operations with disc or cassette 
files to be performed. On entry the contents of the 
accumulator select the operation. The index registers 
are used to pass the address of a parameter block in 
memory where data bytes can be extracted or placed 
by the OSFILE call. 

Calls available 

Accumulator = 0 : Save a block of memory 

Accumulator = 1 : Write parameter block details to catalogue of 

existing file 

Accumulator = 2 : Write LOAD address of file 

Accumulator = 3 : Write *RUN address of file 

Accumulator = 4 : Write file attributes 

Accumulator = 5 : Read catalogue information of file 

Accumulator = 6 ; Delete the file 

Accumulator =255 ; Load file to specified address 

OSFILE parameter block 

XY 0 LSB address of file name string (inc <RETURN>) 

XY -I- 1 MSB address of file name string 
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XY + 2 LSB load address of specified file 
XY + 3 MSB load address of specified byte 
XY + 4 * 

XY + 5 * 

XY + 6 LSB *RUN address of specified file 
XY + 7 MSB *RUN address of specified file 

XY + 8 * 

XY + 9 * 

XY +10 LSB start address of data for save (or length of file) 

XY +11 MSB start address of data for save (or length of file) 

XY + 12 * 

XY ^ 13 ♦ 

XY + 14 LSB end address of data for save (or file attributes) 

XY +15 MSB end address of data for save (or file attributes) 

XY + 16 * 

XY + 17 * 

* These bytes are for use with the 6502 second processor. They 
should contain &FFFF. 

File types 

On return from OSWORD the accumulator will contain information 
regarding the call. The codes are: 

Accumulator = 0 : No file found 
Accumulator = 1 : File found 
Accumulator = 2 : Directory found 

OSGBPB (Operating System Group of Bytes BPUT) 

Entry address &FFD1 
Vector GPBPV &021A 

Entry details Accumulator = call code 

X register = LSB control block 
Y register = MSB control block 

Commentary This call can be used to BPUT or BGET a group of 
bytes to or from a file. 
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Calls available 

Accumulator = 1 ; Use new value of PTR# to put bytes 
Accumulator = 2 : Put bytes to file ignoring new value of PTR # 
Accumulator = 3 : Get bytes using new value of PTR U 
Accumulator = 4 ; Get bytes ignoring new value of PTR # 

Accumulator = 5 : Read title and ! BOOT option. Control block returned 
as: 

Length of title byte 
ASCII title string 
Start option byte 

Accumulator = 6 ; Read directory and device. Details returned are: 
Device ID length byte 
ASCII string of device ID 
Directory name length byte 
ASCII string of directory name 

Accumulator = 1 : Read library and device. Details returned are: 
Device ID length byte 
ASCII string of device ID 
Library name length byte 
ASCII string of library name 

Accumulator = 8 : Read current directories' file names. Note the 
control block must contain the following 
modifications: 

XY + 5 to XY + 8: Number of file names to read 
PTR;« must be zero 

The information returned is as follows: 

Length of first file name byte 
ASCII string of file name 
As above repeated for all file names 
On exit C = 1 if reading was not completed. 

OSGBPB control block 


XY 

+ 

0 

File handle 

XY 

+ 

1 

LSB address of data 

XY 

+ 

2 

MSB address of data 

XY 

+ 

3 

* 
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XY + 4 * 

XY + 5 LSB of number of bytes to BPUT or BGET 
XY + 6 MSB of number of bytes to BPUT or BGET 
XY + 7 * 

XY + 8 * 

XY + 9 LSB of sequential pointer 
XY +10 MSB of sequential pointer 
XY + 11 * 

XY + 12 * 

OSARGS (Operating System ARGumentS call) 

Entry address &FFDA 
Vector ARGSV &0214 

Entry details Accumulator = OSARGS call select code 

X register = address of four-byte parameter block 
in Zero page 

Y register = file handle 

Commentary This routine allows a file's open attributes to be 
written to or read from. The file handle may be 
extracted using a prior OSFILE call. 

OSARGS call with Y = 0 

Accumulator = 0 : Reads into the accumulator a byte specifying the 
active filing system. 

On return; 

Accumulator = 0 : None 

Accumulator = 1 : CFS 1200 Baud 

Accumulator = 2 : CFS 300 Baud 
Accumulator = 3 : ROMFS 
Accumulator = 4 : DFS 
Accumulator = 5 : EFS 
Accumulator = 6 : Telesoftware 

Accumulator = 1 Reads address of line containing parameters passed 

with OS commands, i.e. those prefixed with *. 

Accumulator =255 : Update all files 
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OSARGS calls with Y <> 0 

Accumulator = 0 : Read PTR # 

Accumulator = 1 : Write to PTR# 

Accumulator = 2 : Read EXT # 

Accumulator =255 : Update file 

OSBPUT (Operating System Byte PUT call) 

Entry address &FFD4 
Vector BPUTV 8=0218 

Entry details Accumulator = byte to be put 

Y register = file handle 

Commentary The byte within the accumulator is written to a file at 
the position pointed to by the sequential pointer. The 
file’s handle may be obtained using an OSFIND call. 

OSFIND (Operating System FIND routine) 

Entry address &FFCE 
Vector FINDV &021C 

Entry details Accumulator = call select code 

X register = LSB address of file name (except when 
accumulator = 0) 

Y register = MSB address of file name (except when 
accumulator = 0) 

Commentary This call is implemented to allow files to be opened or 

closed, i.e. performs OPENUP and CLOSE #. 

OSFIND call select codes 

Accumulator = 0 : Open file to be closed 

Y register = file handle 

Accumulator = &40 : Open file for input only 

Accumulator = &80 : Open file for output only 

Accumulator = &C0 : Open file for random access updating only 

OSBGET (Operating System Byte GET Call) 

Entry address &FFD7 

Vector BGETV &0216 
Entry details Y register = file handle 

Commentary A byte is obtained from the position in a file 
indicated by the sequential pointer and is placed in 
the accumulator. 
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31 Function Keys 


The BBC Micro has 16 function keys, eleven of which are readily 
available for use, i.e. the red keys numbered f0 to f9 plus the 
BREAK key numbered as *KEY 10. In addition, the following 
keys may be implemented as function keys using *FX4, 2: 

*KEY11 COPY 
*KEY 12 ^ 

♦KEY 13 -> 

♦KEY 14 i 

♦KEY 15 T 

To reset these keys to their more normal function, use ♦FX 4.0. 
The associated *FX calls of other function keys are: 

♦ FX 18 Clear all ♦KEY string definitions 

♦ FX 225 Read/write key status (codes or keys) 

♦ FX 226 Read/write SHIFT + key status 

♦ FX 227 Read/write CTRL + key status 

♦ FX 228 Read/write CTRL + SHIFT + key status 

These last four calls can be used to define the action performed by a 
key or combination of keys when they are pressed. The values that 
may be passed into the accumulator are: 

0 Ignore key 
1 Act as normally 

X Add X to soft key number to return a code, i.e. ASCII code 
X may be in the range 2-255. 
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Teletext codes 


A useful facility of these calls is to allow the keys to produce 
Teletext control codes using the SHIFT + key combination and 
Teletext graphics codes using the CTRL + key combination. To 
produce the shifted codes use *FX 226, 128. The function keys 
will then produce ASCII codes in the range 128-137: 

SHIFT+ key 

Teletext code 

f0 

Nothing 

fl 

Red alphanumeric 

f2 

Green alphanumeric 

f3 

Yellow alphanumeric 

f4 

Blue alphanumeric 

f5 

Magenta alphanumeric 

f6 

Cyan alphanumeric 

f7 

White alphanumeric 

f8 

Flashing 

f9 

Steady 

To produce the graphic codes using the CTRL + key combination 
use*FX227, 144: 


CTRL+ key 

Teletext graphics code 

f0 

Nothing 

fl 

Red graphics 

f2 

Green graphics 

f3 

Yellow graphics 

f4 

Blue graphics 

f5 

Magenta graphics 

f6 

Cyan graphics 

f7 

White graphics 

f8 

Conceal 

f9 

Continuous graphics 
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ASCII control codes 


Function keys may be programmed to execute ASCII control codes 
by prefixing the CTRL key letter with “ | ”. Thus, Key 0 can be 
defined to produce CTRL L using: 

*KEY0 1 L 


ASCII codes > 128 

Values greater than 128 may be inserted into a function key 
definition by combining two codes. 128 is implemented as j !. 
Simply use an ASCII code to make up the difference. Thus to insert 
140 into Key 9 use: 

*KEY9 [ij L 

This gives 128 + 12 = 140 where 12 = CTRL L. 


Key storage 

Function key definitions are stored in the function key buffer 
occupying Page &B (&B00 to &BFF). The first 16 bytes of the 
buffer form the key pointers, each key having an associated byte, 
the contents of which provide the index from &B00 at which the 
key definition starts. The last byte at &B10 is the key top pointer 
and this holds the index which points to the next free byte in the 
buffer. The key pointers are as follows: 


Key Key pointer 


f0 

&B00 

fl 

&B01 

f2 

&B02 

f3 

&:B03 

f4 

8=B04 

f5 

&B05 

f6 

&B06 

f? 

&:B07 
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Key Key pointer 


fS 

&B08 

f9 

&B09 

fl0<BREAK> 

&B0A 

fll<C0PY> 

&B0B 

fl2 ^ 

&B0C 

fl3 ^ 

&B0D 

fl4 i 

8:B0E 

fl5 T 

&B0F 

Key top 

&B10 


Key definitions are placed in the free bytes between &B11 and 
&BFF. Note that they are placed in the buffer in ASCII format. 
Keywords are not tokenised in the order they are entered, nor in 
their key number order. The position of any key in the buffer can 
be found by: 

PRINT &B0n + (?&B0n + 1) 

where n is the key number in hex. If the associated key pointer byte 
and the key top byte are identical, no definition for that key is 
present. 
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32 Cassette Filing 
System 


All models of the BBC Micro are supplied with a CFS interface. 
This runs at two speeds which are selected with the *TAPE 
command as follows: 

*TAPE 1: Selects 1200 Baud 

*TAPE 3 : Selects 300 Baud 

The default of *TAPE selects *TAPE 1. 

Format 

Files are stored in blocks of data the format of which is as follows: 

1. Five seconds of 2400 Hz tone. 

2. A synchronisation byte, typically &2 A. 

3. File name up to ten characters. 

4. End of file name byte, typically 8c00. 

5. Four-byte load address. 

6. Four-byte execution address. 

7. Two-byte block number. 

8. Two-byte block length. 

9. A block flag byte, bit 7 set on last block. 

10. Four unused bytes set to &00. 

1 1 . Two-byte cyclic redundancy check on header. 

12. Data bytes up to 256 bytes long. 

13. Two-byte cyclic redundancy check on data. 
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CFS commands 

The following commands are used by the CFS: 


BGET # 

(string) 

BPUT # 

(string) 

*CAT 


CHAIN 

(fsp) 

*EXEC 

(fsp) 

INPUT H 

(string) 

LOAD 

(fsp) 

*L0AD 

(fsp), (address) 

♦MOTOR 

(n) 

♦ OPT 

(N) (n) 

PRINT # 

(string) 

♦ RUN 

(fsp) 

SAVE 

(fsp) 

♦ SAVE 

(fsp), (start addr), (end addr + 1) 

♦SPOOL 

(fsp) 

♦ TAPE 

(N) 


CFS error messages 

The following 

errors are generated by the CFS: 

216 

Data cyclic redundancy error 

217 

Header cyclic redundancy error 

218 

Unexpected block number 

219 

Unexpected file name 

220 

Syntax error 

222 

Unopened channel 

223 

EOF (End Of File) error 


CFS OPTS 


The operation of the CFS can be modified in a number of ways by 
using the MOS command *0PT N, n. The possibilities for N and n 
are listed below: 
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♦ OPT 


Reset all parameters to default values. 

♦ OPT 

1,0 

No CFS messages issued. 

♦ OPT 

1,1 

Issue short CFS messages. 

♦ OPT 

1,2 

Issue detailed file information. 

♦ OPT 

2,0 

Ignore all errors but issue messages. 

♦ OPT 

2,1 

Issue re-try prompts on all errors. 

♦ OPT 

2,2 

Abort if error detected. 

♦ OPT 

3.x 

Set gap length between blocks. X is in the range 


0-127 and measured in tenths of seconds. 


The CFS default values for *0PT commands are 

♦ OPT 1,1 

♦ OPT 2,1 

♦ OPT 3,6 

for all operations except BGET#, BPUT#, INPUT# and PRINT# 
when the default values are: 

*0PT 1,0 
*0PT2,2 
*0PT3,25 

Implemented OS calls 

Most of the OS calls are possible with the CFS. Restrictions are as 
follows: 

OSARGS 

Can only be used to identify the current filing system. 

OSFILE 

May only be used to save (A = 0) or load (A = &FF) a file. 
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33 ROM Filing System 


The RFS is standard on all Series 1 or later Operating Systems. It is 
selected using the OS command *R0M. The file format used in the 
RFS is similar to that in the CFS with the following exceptions: 

1. The byte &2B is used as the End o f ROM marker. 

2. With the exception of the first and last blocks, the header may 
be replaced with the single byte &43 (ASCII ,# ). 

3. The four bytes in the CFS are now used to hold the memory 
address of the byte after the end of the file. 


RFS commands 

All CFS commands are relevant, though of course SAVEs and 
SPOOLS can be used only with sideways RAM. The header for an 
RFS file named RFS and loaded in memory at 8c4000 would be 
constructed as follows: 


Byte Function 

2A Synchronization byte 

52 Filename ASC'R" 

46 File name ASC'F " 

53 File name ASC'S " 

00 File name termination byte 

00 Four-byte load address 

40 

FF 

FF 
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Byte 

Function 

23 

Four-byte execution address 

80 


FF 


FF 


00 

Two-byte block number 

00 


00 

Two-byte block length 

01 


00 

Block flag = &80 on last block 

49 

Four-byte address of next byte after end of file 

83 


00 


00 


49 

Two-byte cyclic redundancy check 

51 

File contents follow in next 256 bytes 


OS commands with the RFS 

Almost all OS commands at machine level are possible with the 
following exceptions; 

OSFILE 

ROM cannot be written to. This call is possible if RAM is used. 
OSBPUT 

See OSFILE above. 

OSFIND 

This call is not possible. 
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34 Disc Filing System 


Numerous Disc Filing Systems (DFSs) are available for the BBC 
Micro in single and double density formats. Those examined here 
are the 0.9 to 1.2 series and the 2.10 as available on the BBC B+. 

STANDARD COMMANDS 0.9 TO 1.2 DFSs 

The following commands are available on the 0.9 to 1.2 series DFS 
andDNFS. 


♦ACCESS 

(afsp), (L) 

♦BACKUP 

(source drv), (dest drv) 

♦BUILD 

(fsp) 

♦CAT 

(dr) 

♦COMPACT 

(dr) 

♦COPY 

(source drv), (dest drv), (afsp) 

♦DELETE 

(fsp) 

♦DESTROY 

(afsp) 

♦DIR 

(dir) 

♦DISC 


♦DISK 


♦DRIVE 

(drv) 

♦DUMP 

(fsp) 

♦ENABLE 


♦EXEC 

(fsp) 

♦INFO 

(afsp) 
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*LIB 

(dir) 

♦LIST 

(fsp) 

LOAD 

(fsp) 

♦LOAD 

(fsp) 

♦OPT 

(N). (n) 

♦RENAME 

(old fsp). (new fsp) 

♦RUN 

(fsp) 

SAVE 

(fsp) 

♦SAVE 

(fsp) 

♦SPOOL 

(fsp) 

♦TITLE 

(title) 

♦TYPE 

(fsp) 

♦WIPE 

(afsp) 

mnemonic syntax reads: 

afsp 

Ambiguous file specification 

fsp 

File specification 

dir 

Directory letter 

drv 

Drive number 

src 

Source file 

dest 

Destination file 

L 

Lock 


BBC B+DFS 2.10 

In addition to the above the BBC B+ DFS 2.10 contains the 
following extra or amended commands. 


♦CLOSE 


♦DRIVE 

(drv)(40/80) 

♦EX 

(dir) 

♦FORM 

(40/80) (drv) 

♦FREE 

(drv) 

♦MAP 

(drv) 

♦ROMS 

(ROM ID) 

♦VERIFY 

(drv) 
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WILDCARDS 

Two wildcards are provided on the standard system and may be 
used as follows; 

This allows a single letter to be ambiguous. Thus, *INFO T /#P 
would provide information on files named TAP, TOP and TIP . 

* Complete ambiguity. Thus, *INF0 * would provide information on 
all files. 

DFS ERROR MESSAGES 


Error 

number 

Message 

Cure 

&BD 

Not enabled 

Use * ENABLE 

&BE 

Catalogue full 

Use new disc 

&BF 

Can't extend 

Delete file and resave 

&C0 

Too many open files 

Close one 

&C1 

Read file only 

Unlock file with ^ACCESS 

&C2 

File open 

File already open 

&C3 

File locked 

Unlock file with *ACCESS 

&C4 

File exists 

Rename a file with existing name 

&C5 

Drive fault 

Re-insert disc 

&C6 

Disc full 

Use *C0MPACT or new disc 

&C7 

Disc fault 

Re-insert disc 

&C8 

Disc changed 

Close files on previous disc 

&:C9 

Disc read only 

Remove write protection sticker 

&CA 

Bad sum 

Resave file/change disc 

&CB 

Bad option 

Check OPT arguments being 
used 

&CC 

Bad filename 

7 letter filenames maximum 

&CD 

Bad drive 

: missing or not 0—3 

&CE 

Bad directory 

Use one letter directory 
argument only 

&CF 

Bad attribute 

Use L with ^ACCESS only 

&D6 

File not found 

Check filename 

8cFE 

Bad command 

Re-enter/check command 
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00 


01 


02 


03 


04 


05 


06 


07 


08 

&08 

09 


0A 


0B 


0C 


0D 


0E 


0F 


10 

&08 

11 


12 


13 


14 


15 


16 


17 


18 


19 

&08 

lA 


IB 


1C 


ID 


IE 



IwyvJ 


Initial eight letters of disc title 
as set by *TITLE. 


Seven ASCII characters giving name 

of first file. Starts with byte 

&08. 


Directory name of first file. Bit 7 set if locked. 


Seven ASCII characters giving name 
of second file. Starts with 
byte &08. 


Directory name of second file. Bit 7 set if locked. 


Process repeats for maximum of 
31 files. 


Figure 34.1 Organisation of disc catalogue. Sector 0, Track 0. 
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Last four bytes 
of disc title. 


Number of disc accesses. 


Number of catalogue entries 
multiplied by 8. 

Bits 4, 5 contain IBOOT option. 
Bits 0. 1 contain 2 high bits of 10-bit 
numbers of sectors on disc. 

Eight low bits of 10-bit value of 
number of sectors on disc. 


Low bits of first file’s load address. 


Middle bits of first file’s load address. 


Figure 34.2 Organisation of disc catalogue. Sector 01, Track 00. 
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Low bits of first file’s execution address. 


Middle bits of first file’s execution address. 


Low bits of first file’s length. 


Middle bits of first file’s length. 

High address bits for first file: 

Bits 0.1: Start sector Bits 2.3: Load address 
Bits 4.5: Length Bits 6.7: Execution address 

First file start sector, low 8 bits 
(10-bit number). 


Process repeats for maximum 
of 31 files. 


Figure 34.2 Organisation of disc catalogue, Sector 01, Track 00 cont. 
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Figure 34.3 Disc configuration. 
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Figure 34.4 Disc drive configurations. 
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35 Paged ROMs 


THE ROM HEADER 

To enable the Machine Operating System (MOS) to recognise a 
sideways ROM, the first couple of dozen bytes with the ROM i.e. 
starting from &8000, must be arranged in a specific format; these 
bytes form what is known as the ROM header. The ROM header is 
detailed in Figure 35.1. 


Offset 

Designation 

0 

Language entry point 

3 

Service entry point 

6 

ROM type 

7 

Copyright offset pointer 

8 

Binary version number 

9 

ASCII title string 

9+X 

Terminator byte. &00 

9+X 

ASCII version string 

9+X 

Terminator byte, &00 

9+X 

ASCII copyright string 

9+X 

Terminator byte, &00 

9+X 

Tube relocation address 

The value of X will vary depending on the length of each preceding 
item. 


Figure 35.1 Format of the ROM header. 
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The value under the heading Offset indicates the number of bytes 
from the start of the ROM at which the specific item can be found, 
thus the ROM type with an offset of 6 can be found at &8000 +6 or 
simply &8006. The first ten bytes of the ROM header are therefore 
fixed and may always be found at a specific address. 

The ROM Type Table 

The address of this is found using an OSBYTE 170 call as follows: 

10 A% = 170 
20 X% = 0 
30 Y% = 255 

40 addr% = (USR (&FFF4)) AND &FFFF00 
50 addr% = addr% DIV 256 
60 PRINT ~addr% 

Figure 35.2 details the addresses associated with each ROM in the 
ROM type table. TTie addresses are for OS 1.0 and OS 1.2. 


Table 

ROM number 

&2A1 

0 

&2A2 

1 

&2A3 

2 

&2A4 

3 

&2A5 

4 

&2A6 

5 

&:2A7 

6 

&2A8 

7 

&2A9 

8 

&2AA 

9 

&2AB 

10 

&2AC 

11 

&2AD 

12 

&2AE 

13 

&2AF 

14 

&:2B0 

15 


Figure 35.2 The ROM type table. 
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ROM TYPES 

The byte at &8006 contains the ROM type; this provides the MOS 

with information about the ROM. The byte is organised at bit level 

as follows: 

Bit 7 This bit is set if the ROM has a service entry, therefore it 
must always be set as all ROMs must have a service entry 
point. The only exception to this rule is BASIC. 

Bit 6 This bit is set if the ROM has a language entry point. 

Bit 5 This bit is set if the ROM has a second processor relocation 
address. For this to happen the code in the ROM. bar the 
service entry coding, must have been assembled with the 
second processor addressing in mind. The service call 
coding is not copied across the Tube: only languages may be 
copied across the Tube. 

Bit 4 This bit is used by ROMs operating on the Electron only. If 
set it controls the use of soft key expansion allowing the 
Electron to implement function key operations using the 
CTRL and SHIFT sequences, as these are not normally 
available. 

Bits Not used-set to zero. 

Bit! Not used-set to zero. 

Bit I Must always be set. 

Bit0 Not used-set to zero. 
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Part Four 
The Hardware 




















DISC INTERFACE 


Pin 

Use 

Pin 

Use 

1 

GND 

18 

Direction 

2 

— 

19 

GND 

3 

GND 

20 

Seek step 

4 

— 

21 

GND 

5 

GND 

22 

Write data 

6 

— 

23 

GND 

7 

GND 

24 

Write enable 

8 

Index 

25 

GND 

9 

GND 

26 

Track 0 

10 

Drive select 0 

27 

GND 

11 

GND 

28 

Write protect 

12 

Drive select 1 

29 

GND 

13 

GND 

30 

Read data 

14 

— 

31 

GND 

15 

GND 

32 

Side select 

16 

Load head 

33 

GND 

17 

GND 

34 

— 
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IMHZ BUS INTERFACE 


V 

1 


oooooooooooooo 

oooooooooooooo 


34 


Pin 

Use 

Pin 

Use 

1 

GND 

18 

D0 

2 

R/NW 

19 

D1 

3 

GND 

20 

D2 

4 

IMHzE 

21 

D3 

5 

GND 

22 

D4 

6 

NNMI 

23 

D5 

7 

GND 

24 

D6 

8 

NIRO 

25 

D7 

9 

GND 

26 

GND 

10 

NPGFC 

27 

A0 

11 

GND 

28 

A1 

12 

NPGFD 

29 

A2 

13 

GND 

30 

A3 

14 

NRST 

31 

A4 

15 

GND 

32 

A5 

16 

Analogue in 

33 

A6 

17 

GND 

34 

A7 


181 




PRINTER PORT 

V 


1 


c 

1_1 

oooooooooo 

oooooooooo 

o o o 

o o o 

] 


26 



Pin 

Use 

Pin 

Use 

1 

CA2 

14 

GND 

2 

GND 

15 

PA6 

3 

PA0 

16 

GND 

4 

GND 

17 

PA7 

5 

PAl 

18 

GND 

6 

GND 

19 

CAl 

7 

PA2 

20 

GND 

8 

GND 

21 

n/c 

9 

PA3 

22 

GND 

10 

GND 

23 

n/c 

11 

PA4 

24 

GND 

12 

GND 

25 

n/c 

13 

PAS 

26 

n/c 


n/c = not connected 
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USER PORT 



V 

1 



r 

oooooooooo 

1 


L 

o ooooooooo 

J 



20 



Pin 

Use 

Pin 

Use 

1 

+5 Volts 

11 

GND 

2 

CBl 

12 

PB3 

3 

+5 Volts 

13 

GND 

4 

CB2 

14 

PB4 

5 

GND 

15 

GND 

6 

PB0 

16 

PBS 

7 

GND 

17 

GND 

8 

PBl 

18 

PB6 

9 

GND 

19 

GND 

10 

PB2 

20 

PB7 
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ANALOGUE PORT 
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37 Keyboard Links 


Eight links are situated at the front right-hand side of the keyboard 
PCB (See Figure 37.1). Making combinations of these links allows 
the default screen mode selected on BREAK and disc access timings 
to be altered. On a cassette-based machine, these links will appear 
as holes. On models fitted with the DFS, a set of DIL switches may 
be installed. Normally, these links are in the unmade state. By 
making links, or sets of links, various modifications to the 
operation of the system can be effected. These hardware links and 
their functions are listed in the following tables. They may be 
patched in using the MOS software through an *FX 255 call. The 



Figure 37.1 Keyboard links. NB: On later issue boards, links run 
vertically down the bottom right-hand corner of keyboard PCB. 
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accumulator should hold the link byte, where each bit reflects the 
corresponding link. A made link is reflected as a set bit, and an 
unmade link as a cleared bit. Thus, Mode 0 could be selected as the 
default mode on a reset by executing *FX 255, 7. 


THE LINKS 


Link 

Function 

1 

Unused 

2 

Unused 

3 

Disc access timings 

4 

Disc access timings 

5 

Made = BOOT on <BREAK> 

Unmade = BOOT on <SHIFT-BREAK> 

6 

Select power-on mode 

7 

Select power-on mode 

8 

Select power-on mode 


DISC ACCESS TIMING DETAILS 


Bits 

3 4 

Step rate 

Settle time 

Head load 

0 0 

24 

20 

16 

0 1 

6 

50 

8 

1 0 

6 

16 

0 

1 1 

4 

16 

0 


1 = link made 
0 = link unmade 


All timings in milliseconds 
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MODE SELECT DETAILS 


Screen mode 

Link 6 

Link? 

Link 8 

7 

0 

0 

0 

6 

0 

0 

1 

5 

0 

1 

0 

4 

0 

1 

1 

3 

1 

0 

0 

2 

1 

0 

1 

1 

1 

1 

0 

0 

1 

1 

1 


1 = Link made 
0 = Link unmade 
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38 The User Port 


The user port on the BBC Micro utilises Port B of the User 6522 
Versatile Interface Adaptor (VTA). Port A of this device being 
connected to the printer port as part of the memory associated with 
SHEILA. Table 38.1 lists the function, absolute address and offset 
value associated with each register of the VIA. 


Table 38.1 


Address 

SHEILA offset 

Register 

&FE60 

&60 

DRB 

Data Register B 

&FE61 

&61 

DRA 

Data Register A 

&FE62 

&62 

DDRB 

Data Direction Register B 

&FE63 

&63 

DDRA 

Data Direction Register A 

&FE64 

&64 

TICL 

Timer 1 low order counter 

&FE65 

&65 

TICH 

Timer 1 high order counter 

&FE66 

&66 

TILL 

Timer 1 low order latch 

&FE67 

&67 

TIHL 

Timer 1 high order latch 

&FE68 

&:68 

T2CL 

Timer 2 low order counter 

&FE69 

&69 

T2CH 

Timer 2 high order counter 

&FE6A 

&6A 

SR 

Shift Register 

&FE6B 

&6B 

ACR 

Auxiliary Control Register 

&FE6C 

&6C 

PCR 

Peripheral Control Register 

&FE6D 

&6D 

IFR 

Interrupt Flag Register 

&FE6E 

&6E 

lER 

Interrupt Enable Register 

&FE6F 

S:6F 

ADRA 

Alternative Data Register A 
with no handshaking 


THE REGISTERS 


A brief description of the function of each of the VIA registers 
follows: 


IRB/ORB 

ORA 

DDRB 

DORA 

TICL/TICH 

TILL/TIHL 

T2C-L/T2C-H 

SR 

ACR 


This user port register is used to hold data which is 
waiting to be written externally, i.e. waiting for 
output, or has just been input and is waiting for 
processing. 

This printer port register is used to hold data to be 
written to an attached printer. It must never be used to 
input data bytes. 

This user port register is used to determine whether 
the associated line in the data register is to be used to 
input or output data. A 0 in a DDR bit will designate the 
associated line as an input, while a 1 in a DDR bit will 
designate the line as an output. 

This printer port register should never be altered, and 
is permanently set for output. 

These bytes act as a programmable 16-bit timer/ 
counter. This has four operational modes determined 
by bits 6 and 7 of the ACR. 

These two registers act as a latch for the TICL and 
TICH. They may be written to without affecting the 
operation of the timer proper. 

Timer 2 has two modes of operation, selected by bit 5 
of the ACR. and may be used to generate a single time 
interval or to count input pulses on bit 6 of the user 
port. 

The shift register is connected to CB2 on the user port 
and can be used to shift a byte serially out or in. It may 
also be used to synchronize the transfer of data 
between two micros. Bits 2.3 and 4 of the ACR control 
its operation. 

The auxiliary control register is used to control three 
functions on the BBC Micro. These are the latching on 
the two associated ports, and the mode of operation of 
the timers and shift register. These functions are 
determined by the state of individual bit patterns as 
follows: 
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Auxiliary Control Register 


ACR bit 

State 

Function 

7 

0 

timer 1—disable output on PB7 


1 

timer 1—enable output on PB7 

6 

0 

timer 1—one shot running mode 


1 

timer 1—free running mode 

5 

0 

timer 2—decrement with one shot mode using machine clock 


1 

timer 2—decrement set number of pulses on PB6 

4,3.2 

000* 

shift register disabled 


001 

shift in by timer 2 rate 


010 

shift in by machine clock rate 


011 

shift in by external clock rate on CBl 


100 

free running output by timer 2 rate 


101 

shift out by timer 2 


110 

shift out by machine clock rate 


111 

shift out by external clock rate on CBl 

1 

0 

port B—disable input latch 


1 

port B^—enable input latch 

0 

0 

port A—disable input latch 


1 

port A—enable input latch 


PCR The peripheral control register controls the operating 

modes of the four control lines CAT CA2, CBl and 
CB2. The associated bits are; 


Peripheral control 
register 


Bit 

Function 

PCR7 

CB2 control 

PCR6 

CB2 control 

PCR5 

CB2 control 

PCR4 

CBl control 

PCR3 

CA2 control 

PCR2 

CA2 control 

PCRl 

CA2 control 

PCR0 

CAl control 


Bit 0 defines the type of active transition that will set 
the CAl interrupt flag as follows: 


1 : Low to high transition 


0 : High to low transition 
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The operation of bits PCRl to PCR7 are as follows; 


Control of CA2 as input to VIA 


PCR3 

PCR2 

PCRl 

IFR0 set by* 

IFR0 cleared by 

0 

0 

0 

high-to-low 

ORA read/write or write IFR0 = 1 

0 

0 

1 

high-to-low 

write IFR0 = 1 only 

0 

1 

0 

low-to-high 

ORA read/write or write IFR0 = 1 

0 

1 

1 

low-to-high 

write IFR0 = 1 only 

* active transition conditions 





Control of CA2 as output from VIA 

PCR3 

PCR2 

PCRl 

Mode 

CB2 operation 

1 

0 

0 

handshake 

CA2 high on active transition of CAl. low 
on read/write to ORA 

1 

0 

1 

pulse output 

C A2 goes low for one cycle after read/write 
of ORA 

1 

1 

0 

output low 

CA2 held at constant low 

1 

1 

1 

output high 

CA2 held at constant high 

IFR 


The interrupt flag register operates in tandem with the lER. 
It is used to flag actions associated with the timers, control 
lines and shift register. The flags are conditioned as follows: 




Control of CB2 as input to VIA 

PCR7 

PCR6 

PCR5 

IFR3 set by* 

IFR3 cleared by 

0 

0 

0 

high-to-low 

ORB read/write or write IFR3 = 1 

0 

0 

1 

high-to-low 

write IFR3 = 1 only 

0 

1 

0 

low-to-high 

ORB read/write or write IFR3 = 1 

0 

1 

1 

low-to-high 

write IFR3 = 1 only 

* active transition conditions 





Control of CB 2 as output from VIA 

PCR7 

PCR6 

PCR5 

Mode 

CB2-operation 

1 

0 

0 

handshake on 
write only 

high on active transition of CBl 

1 

0 

1 

pulse output 

goes low for one cycle after write to ORB 

1 

1 

0 

output low 

held at constant low 

1 

1 

1 

output high 

held at constant high 
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lER 


ORA/IRA 


The interrupt enable register is used to enable or 
disable individual interrupt requests. It is organized 


as follows: 



IER7 

lER 

set/clear control 

IER6 

T1 

interrupt enable 

IER5 

T2 

interrupt enable 

IER4 

CBl 

interrupt enable 

IER3 

CB2 

interrupt enable 

IER2 

SR 

interrupt enable 

lERl 

CAl 

interrupt enable 

IER0 

CA2 

interrupt enable 


If a write operation is performed with bit 7 (IER7) set 
and any of the remaining bits are set, the interrupt 
represented by those bits is enabled. In other words it 
will cause an interrupt if so required. 


This register is associated with the printer port and 
should not be altered. 


192 




39 FRED, JIM and 
SHEILA 


These names are given to three pages of memory at the top of the 
Operating System. The range of memory associated with each is; 


Name 

Address range 

FRED 

8cFC00 to &FCFF 

JIM 

&FD00 to &FDFF 

SHEILA 

&FE00 to&FEFF 


THE IMHz BUS 

The memory areas defined by FRED and JIM are associated with 
the IMHz bus. The term IMHz refers to the fact that it operates at 
1 000 000 cycles per second. The bus terminates at the edge of the 
main PCB next to the user port. Memory within FRED has been 
reserved for commercially produced peripherals as follows: 


Address 

Application 

&:FC00 

to &FC0F 

Testing equipment 

&FC10 

to &FC13 

Teletext 

&FC14 

to &FC1F 

Prestel 

&:FC20 

to &FC27 

IEEE488 interface 

&FC28 

to &FC2F 

Expansion 

&FC80 

to &FC8F 

Testing equipment 

&FCC0 

to ScFCFE 

User applications 

&FCFF 


Paging register 


The memory provided by JIM used in conjunction with FRED’s 
paging register enables up to 64K of memory to be added. Both 
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FRED and JIM may be written to or read from using an OSBYTE call 
with the accumulator containing the hex value detailed below. The 
X register holds the Offset into the page and the Y register holds the 
byte to be written or. if reading, returns the byte. The read/write 
codes are detailed below; 


Name 

Read A%= 

Write A% = 

FRED 

&92 

&93 

JIM 

&94 

&:95 


SHEILA 

The memory associated with SHEILA is generally allocated to be 
memory mapped against many of the registers of the onboard 
hardware, such as the user port VIA and 6845 CRTC. The 
following table details the areas allocated with addresses specified 
as an offset from &FE00. This offset value should be resident in the 
X register prior to reading or writing information. The read/write 
OSBYTE codes for SHEILA are as follows: 

Read A = &96 
Write A = &97 


Address 

Page Offset 

Designation 

&FE00 

to &FE07 

&00 

to 8=07 

6845 CRTC 

&FE08 

to &FE0F 

&08 

to 8=0 F 

6850 ACIA 

&FE10 

to &FE1F 

&10 

to 8=1F 

Serial ULA 

&FE20 

to &FE2F 

&20 

to 8=2F 

Video ULA 

&:FE30 

to &FE3F 

&30 

to 8=3 F 

Paged ROM ID 

&FE40 

to &FE5F 

8=40 

to 8=5 F 

Internal 6522 VIA 

&FE60 

to &FE7F 

&60 

to 8=7F 

User port 6522 VIA 

&:FE80 

to &:FE9F 

8=80 

to 8=9F 

8271 floppy disc controller 

&FEA0 

to &FEBF 

8cA0 

to 8=BF 

68B54 ADLC Econet 

controller 

&FEC0 

to &FEDF 

S:C0 

to 8=DF 

pPD7002 analogue to digital 
converter 

&FEE0 

to &FEFF 

8=E0 

to 8=FF 

Tube ULA 
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40 6845 CRTC 


The 6845 cathode ray tube controller operates in tandem with the 
video ULA to produce the screen display. It contains 18 registers of 
which 14 are write only, two are read only and two are read and 
write registers. Programming these registers is easiest using the 
VDU 23 statement as described in Section 15. To read a register 
then, locations &00 and&01 of SHEILA must be used. (See Section 
38 for details.) 


THE REGISTERS 

Register 0: Horizontal character total 

Holds the total number of characters, displayed and undisplayed, 
minus one per mode. This value is used for timing purposes. 

Register 1: Character cells per line 

Holds the number of displayed character cells per line for each of 
the screen modes. 

Register 2: Horizontal sync, pulse position 

Determines the position of the sync, pulse on the horizontal line 
axis. 

Registers: Sync, width 

Determines the width of the horizontal and vertical sync, pulses. 


Register 4: Vertical character total 

Holds the number of character lines, displayed and undisplayed, 
per mode. 
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Register 5: Vertical sync, fraction 

Holds a value to determine the exact frequency of the vertical 
refresh rate as used by Register 4. 

Register 6: Vertical character total 

Holds the number of displayed character rows per line for each 
screen mode. 

Register 7: Vertical sync, pulse position 
Determines the position of the vertical sync. 

Register 8: Interlace control 

This register controls both interlace and blanking. Bits 0 and 1 
determine interlace or non-interlace display. Bits 4 and 5 control 
the blanking signal and bits 6 and 7 the cursor blanking delay. Bits 2 
and 3 are unused. 

Register 9: Scan lines 

Determines the total number of scan lines minus one. and including 
spaces, per character. 

Register 10: Cursor details 

Holds details regarding the cursor size and flash rate. Bits 0 to 4 
determine the scan line on which the cursor starts. Bit 5 sets either a 
fast or slow flash rate and bit 6 enables or disables the cursor. 

Register 11: Cursor scan line end 
Determines on which scan line the cursor ends. 

Register 12: Cursor position (low) 

Holds the low order bits of the cursor’s 14-bit position on the 
screen. 

Register 13: Cursor position (high) 

Holds the high order 6 bits of the cursor’s 14-bit position on the 
screen. 

Register 14: Cursor position (low) R/W 

As Register 12. except that this register is a read/write register. 

Register 15: Cursor position (high) RjW 

As Register 13. except that this register is a read/write register. 
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Registers 16 and 17: Light pen position 

These two registers combine to return a 14-bit address reading the 
current position of a light pen signified by the LPSTB line going 
high. 


DEFAULT SETTINGS 


The following list details the default setting for the 6845 CRTC 
registers: 


Register 

0 

1 

2 

Mode 

3 

4 

5 

6 

7 

0 

127 

127 

127 

127 

63 

63 

63 

63 

1 

80 

80 

80 

80 

40 

40 

40 

40 

2 

98 

98 

98 

98 

49 

49 

49 

51 

3 

40 

40 

40 

40 

36 

36 

36 

36 

4 

38 

38 

38 

30 

38 

38 

30 

30 

5 

0 

0 

0 

2 

0 

0 

2 

2 

6 

32 

32 

32 

25 

32 

32 

25 

25 

7 

34 

34 

34 

27 

34 

34 

27 

27 

8 

1 

1 

1 

1 

1 

1 

1 

147 

9 

7 

7 

7 

9 

7 

7 

9 

18 

10 

103 

103 

103 

103 

103 

103 

103 

114 

11 

8 

8 

8 

'9 

8 

8 

9 
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Register status 

The following list defines the read/write status of each 6845 
register. 

Register Status 

0 Write only 

1 Write only 

2 Write only 

3 Write only 

4 Write only 

5 Write only 

6 Write only 

7 Write only 

8 Write only 
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Register 

Status 

9 

Write only 

10 

Write only 

11 

Write only 

12 

Write only 

13 

Write only 

14 

Read/write 

15 

Read/write 

16 

Read only 

17 

Read only 
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41 


Analogue to Digital 
Converter 


The analogue to digital converter has four channels, numbered 1 to 
4 (though these are also often referred to as 0 to 3), which are 
selected using the *FX 16 command. The converter itself is a 10-bit 
device and occupies addresses &C0 to &C2 inclusive within 
SHEILA. Of these three registers only one may be written to. 

Values from the converter may be read using the ADVAL 
command using a negative parameter, as the ADVAL argument 
allows the number of characters in or left in the related buffer to be 


ascertained: 


ADVAL(-1) 

Characters present in keyboard buffer 

ADVAL(-2) 

Characters in RS423 input buffer 

ADVAL(-3) 

Space left in RS423 output buffer 

ADVAL(-4) 

Space left in printer buffer 

ADVAL(-5) 

Space left in SOUND channel 0 buffer 

ADVAL(-6) 

Space left in SOUND channel 1 buffer 

ADVAL(-7) 

Space left in SOUND channel 2 buffer 

ADVAL(-8) 

Space left in SOUND channel 3 buffer 

ADVAL(-9) 

Space left in SPEECH buffer 


THE REGISTERS 


Data Latch/A—D Start and Status: &FEC0 

This register may be either written to or read from. In a write 
operation. only bits 0 to 3 are used. The function of the bit or bits is: 
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Bits 0.1: Select input channel 
B0 B1 

0 0 Channel 1 

1 0 Channel 2 

0 1 Channel 3 

1 1 Channel 4 

Bit 2: Normally set to 0 to signal an input condition. 

Bit 3: Selects either a ten-bit (B3 = 1) or eight-bit 
conversion (B3 = 0). 

For a read operation the register acts as a Status register to define 
current conditions. All bits except bit 2 are used. 

Bits0andl;As for write operation 
Bits : Signals conversion mode as above 

Bit 4 : 10-bit conversion, bit 10 of result 

Bit 5 : 10-bit conversion, bit 9 of result 

Bit 6 : Clear if busy 

B i t 7 : Clear if conversion finished 

Data byte: &FEC1 

This read-only register holds the most significant eight bits of the 
conversion result. 

Low bits: &FEC2 

This read-only register holds the low four bits of the conversion 
result in bits 4 to 7. Bits 0 to 3 are unused. 
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Th is book is a complete reference guide to all aspects of the 
BBC Micro including the BBC B + . It is arranged in five 
sections to include details of BASIC, assembler, the 
machine operating system, the filing systems and the 
hardware itself. No other book has included such a wealth 
of useful information - no longer is it necessary to plough 
through several different books to locate a single detail. 

Each of the five sections is laid out logically arid is easy to 
use. Vital information is presented in tables for ready 
reference. The BASIC section includes details on all 
commands, graphics, including suitable graphics planning 
sheets, and more advanced information on variable 
storage. 

The assembler section includes a detailed description of 
6502 mnemonics, while the section describing the MOS 
looks at all the OS calls. Filing system coverage includes 
the CFS, DFS (including the B+ DFS 2.0) and the lesser 
known ROM filing system. Full details of the new B+ are 
provided . Finally, the details of ports, keyboard links 
and the programmable chips on the Beeb are set out. 
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Bruce Smith is Technical Editor of Acorn User, and is known os 
on authority on the BBC Micro. He has written over o dozen 
books on many aspects of computing. 
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